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The verdict is: Ones a pleasure, 
two are useful, and one S a pain. 
Scores run from 7.2 

to 2.7, fram worthy 

to worthless. 
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Theresa 
saving that 
good design is invisible. As Ward 
Cunningham puts it, “Good class 
libraries whisper the design in your 
ear." This is the case with zApp, 
which straightjorwardly provides 
all the usual classes you'd expect 
in building event-drawn GUI 
programs: a main application class, 
a small hierarchy of event handling 
classes, classes for graphic display, 
window-containing classes, and the 
usual GUI widgets (push buttons, 
check box, list bax, and so on). 
There are no radical concepts or 
unpleasant surprises, greatly easing 
any learning curve associated with 


a brand-new API. 
Ray Valdéx - October, 1992 
The doc- 


Program | ; 
umentanon 


provided with zApp is little short 

of superb. zApp 2.0 is a professional 
product which turns platform- 
independence into a practical 
proposition by its efficient, versatile 
and function-rich implementation, 








When presenting 


zApp with their 


Editor s Choice Award, Willie 
Watts explained why he “plumped 


Jor zApp AS Of all the C++ encap- 


sulations of Windows in all the bars 
in the world, we both felt this was 
the best attempt we had seen, and 
was something of a landmark in the 
use of this important language. 


OBJECT- ORIENTED 
Prograrmins 


The class design is the most impoar- 
fant and most subjective aspect of 
a class library, and I think zApp ss 

is superb, zApp encapsulates the 
entire underlying native APL. 

In other words, if you want a 
Windows dialog, you get a Windows 
dialogue, not something that looks 
like one. 


. The /992 Star 
Tech Award for 
C/C++, and 


iT ee 
Application Frameworks goes ta 
Inmark Development Corp s zApp 
V2.0. zApp is simply the best 
designed application framework 
on the market. [ts well-conceived 


classes make Windows programming 
an easier and more manageable 
process-and even fun. If C++ is 


vour language of choice, then you 


should be using zApp. Periad. 


. purpose 


applications that arent limited to 
text, basic graphics, and dialog 
boxes, however, | suggest evaluating 
zApp first. Features like advanced 
graphics, printing support, DDE, 
compatibility with third-party 
resource tools, and the ability to 
incorporate custom controls can 

be hard to live without... 


Reprinted from “COMPUTER SHOPPER” Seppe 1993 
Copyright® | 00 2i7-Devia Publistilag Company 


As long as you write 
your applications 

using zApp objects, 

you can create 
programs for one compiler or 
environment and recompile them 
with another compiler for a different 
environment without any changes... 
zApp *s object hierarchy remains the 
mast comprehensive I've vet seen 
in.an application framework. 


Reprinted from “PC MAGAZINE” Dec 22, /e92 
Capen 900) 2f- Gov Palisking Company 


((++REPORT 


Marketing people say things like 
“zApp is great. It contains over 
200 classes,”’ That looks good in 

a slick and glossy brochure, but it 
leaves the fundamental question 
unanswered: Are they good classes? 
They are. zApp 8 classes are well- 
implemented and easy to use. The 
library covers the full breadth of 
contemporary functionality and 
affers portability across most major 
operating Systems. 


What I've 
noticed 
about the 
company behind the product is that 
Inmark's customer technical support 
is outstanding (usually a returned 
call within four hours), their BBS 

is full af great information, and 
their attention to quality 
is stellar. 1 wish all 
software tool providers 
did as well. 








PGWEEK >i: 
Brittingham, 

a user-interface specialist with 

AT&T Bell Labs in Middletawn, NJ. 

chose zApp over other frameworks. 
“You can see it's built by someone 

who builds applications,” 


Reprinted faa (PO WEEA” shai eM Pa 
Copyright® (040 2i7-Devis Publishing Company 


With the 
addition 

of a visual 
screen builder, the final barrier to 
zApp productivity has fallen. For 
quick, form-based applications, 
zApp Factory makes C++ produc- 
tive enough to be competitive with 
the interpreted languages. For more 
serious applications, the zApp 
jJramework is a superior application 
framework, I would use it even if 

| were just programming for 
Windows, but the fact that it 
compiles for Windows, Win/NT, 
OS/2, UNLX, and X/Moatif, is 


a nice litthe honus. 










Award winning developers use Award winning fools. 


With the award winning zApp” Developer’s Suite, you can quickly build state-of-the-art C++ applications 
that run across fourteen of today’s most popular operating systems. The zApp Developer’s Suite contains 
the latest in drag-and-drop design, prototyping and testing, code generation, and powerful GUI objects. 
Best of all this powerful technology sits on top of zApp, the industry leading application framework in 
use by tens of thousands of developers worldwide. 








For a free demo call: 1-800-346-6275 











Inmark Development Corporation 2065 Landings Drive, Mountain View, CA 94043 (00) 346-6275, (415) 691-9000 Fax: (415) 691-9099 
In the U.K. and Scandinavia, call PTS/Software Plus at +44 (0) 928 579900, In France, call PTS/Software Plus at (05) 908194, In Germany, call ESM Software at (17702-9256-0, 
In Italy, cull Sitcom Valley On-Line at (049) 8719820, In Australia, call Micro Way at (03) 580-1333, BBS: 415-691-9990 « Internet: infoi@inmark.com « CompuServe: GO INMARK 


It Took Teamwork to Reach 
the Moon 





With the all new VisPro 3.0, your OS/2 programming 
team can work together, at a price that’s down-to-earth 


For years, the VisPro family of visual programming 
products has made OS/2 programming easy with 
Workplace Shell-enabled drag and drop 
programming. Our responsive and FREE technical 


support never leaves customers drifting in space. Now, 
whether you're part of a large OS/2 development crew 


or flying solo, the all-new VisPro/REXX Gold, VisPro/C 
and VisPro/C++ will guarantee you a smooth 
client/server programming ride. 


Team Development 

Take a seat at mission control with VisPro 3.0’s Team 
Administrator. Compare change levels and project 
versions with ease, rollback changes, and monitor 
development progress. Team development also gives 
you automatic change logging, form shadowing, form 
locking and read-only browsing; all seamlessly 
integrated, so you don’t need to be a rocket scientist. 


Support for More Databases 
With VisPro’s entity/relationship Database Designer, 
you can now design and reverse-engineer IBM DB2, 


Watcom SQL, or any ODBC-enabled database. 
Generating DDL is fast and easy. VisPro/C and 
VisPro/C++ now generate native embedded SQL for 
Sybase, Oracle, IBM DB2 and Watcom SQL. VisPro 3.0 
makes database programming easier than ever. With a 
simple drag and drop, you can instantly generate GUI 
panels for adding, changing, deleting and searching 
for rows in a table. The all new join and drill-down 
support makes creating complex queries a breeze. 


Other Essential Gear 

The VisPro/Paint image editor is included free to 
allow you to edit BMP, TIF, GIF, and many other image 
formats. The VisPro IPF Help File editor makes it 
easier to create online help for your applications. 


Both VisPro/C and VisPro/C++ now support the IBM 
VisualAge C++ and MetaWare High C compilers. In 
addition, VisPro/C also supports the Borland and 
Watcom OS/2 compilers. VisPro/REXX includes 
hundreds of new APIs, Dynamic Data Exchange 
(DDE) support and an improved multi-threaded 





REXX debugger with support for conditional break 


points and animation. 

The Complete VisPro Family 

VisPro/REXX Gold 3.0..........s000. $299 
VisPro/REXX Bronze. ...........+++-.$ 59 
VisPro/REXX Data Entry Object Pack ....$ 89 
VisPro/C or VisPro/C++ 3.0........... $299 
VisPro/Reports oo. ccc ccevessieces G19D 
VisPro Development Suite 5.0......... $499 


Whether you've already 
discovered the VisPro family 
of visual programming 
products of you're just 
getting to know us, VisPro 
3.0 will take you where you 
want to go. 
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| HockWare Incorporated 
P.O. Box 336 

. NC 27512-0336 
919-380-0616 
919-380-0757 FAX 
Go HockWare on CompuServe 
hockware@vnet.net on Internet 
http:/www.hockware.com/hockware 


HockWare, VisPro/C, VisPro/C++, VisPro/REXX and VisPro/Reports are trademarks of HockWare Incorporated. All other company, product and brand names are trademarks and/or registered trademarks of their 
respective holders and are mentioned for reference purposes only, ©1995 HockWare Incorporated. All rights reserved. 
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Visual SlickEdit 
bd Os/2— 


s editor 
by MicroEdge, Inc. 
This high-powered programmer's 
‘editor is completely customizable 
with the speed to ignite your pro- 
ductivity. Save time using BRIEF, 
Emacs, or VI emulations. Take 














‘off with Visual SlickEdit’s GUI interface, built-in dialog editor, 
and C-style macro language. Features include: SmartPaste™; 


Compiler error processing; syntax color-coding; expansion and 


indenting; and an on-line manual. 30 day risk-free trial! 
Discount Price: *219* 
Paradise No. MEVSE3100-E! 











1yt east Lite, the easy-to- 
; | bundled with 





* Offer ends December 31, 1995. 
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) Warp. HyperACCESS for 
comes packed with exciting 







Remote Control on the products =| 
Anything you can run on a PC with 12 
) ) fercle[-)- Mer: || eles 
OS/2 you can now do remotely via | - + 
LAN, Modems, or Serial Cable. You 800 Number a ™~ 
can run: the remote computer’s entire and we will fax reret, [nbs 
OS/2 desktop; presentation manager itiora 
programs—both 16- and 32-bit; tig = ing / 
command sessions or text mode. ..win- lelielapraitelar \— 
dowed or full screen; Microsoft ) 
Windows “seamless” or full screen; and DOS sessions or pro-— 
grams, windowed or full screen. Runs on Novell & IBMLANs. ~ 
Discount Price: "119 P 
Paradise No. HGKKO3100-El #7 
IBM® VisualAge™ C++ Miore Moor Setters! 
Version 3.0 
by IBM 
IBM VisualAge C++ V3.0 combines 
the productivily-boosting visual 
programming capability of IBM 
VisualAge with robust, professional 





development tools from the popular 
IBM C Set++> product. This powerlul 


oes) sheimiae a resource 






by FarCcom Easeration 

DOS « WINDOWS « NT « UNIX + 
05/2 « SUN « RS6000 + HP9000 + 
MAC + ONX « BANYAN = SCO. 
This well known, highly portable data 
management package has become 
established as the tool of choice for 


commercial development. Offering FAIRCONM" 


ted data control, choose since 1979 


direct low level access, ISAM 


or SQL access with the FairCom Server. Single-User, 
ticUser, Or optional Client/Server, ANSI Standard. Full 


Source. No Royalties. 
‘Discount Price: *769 
Paradise No, FACT+3100-EI 


combo lets you visually build parts then assemble them into 
mission-critical, object-oriented programs 


DataTable 

for OS/2 

by ProtoView 

Development Corp. 

DataTable is a sophisticated 

spreadsheet control. Through 

a robust message-based API 

and numerous notification codes, developers can control every — 
aspect of their application. Features include: virtual memory | 
management; column sorting: column locking; check boxes and” 
combo boxes; and colors and fonts may be set on a cell, row, — 


column or table basis. New for OS/2, vertical window splitting. 


Discount Price: *476 
Paradise No, PDDTO3100-EI 








SPF/PC Version 4.0 o) 
by Command 

Technology Corp. 
Provides a familiar enviro ime nt 
on the PC for ISPF/PDF m 


tcom 1 VX*REXX 
t/Server 2. 1 
nN International 
al = eal environment 


2. Powerful connection, query 


; Phone order 
800 445 7899 

FAX order 

908 389 9227 
International Sales 


hart objects allow you to access 
il databases, manipulate data 
shart the results quickly and 
y. Features include: drag-and- 
programming; bound controls; 
fessional multi-threaded, 
-windowed and drag-and-drop 


ed application development. 





frame programmers. Inclu 
Modifiable Panels & T 
Services; UNDO/REDO; Pr 

Source Colorization; SUPERC 
mouse support; 64,000 max. 
and 20+ new primary comn s. OPPPL feat 

compatibility; ISREDIT mi via REXX; / 116 
file editing; COBOL workbench integration; C : 

fully mappable keyboard; and ke 
Discount Price: 199 ; 


908 389 9229 


Avenue 
picaunbun, NJ 07702-4321 


Paradise No. CTSP43100-EI 
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Fast Visual Application Development 
_ Tor Os/2 and UB2 


D Waloun If you're looking for fast and easy application 
i | development for OS/2, then take a look at the award- 
= casei . Winning Watcom VX*REXX visual development 





environment. VX*REXxX lets you build applications to 
exploit the graphical user interface, multi-threading, 
and multi-processing power of OS/2. VX*REXX 
Client/Server Edition gives you the added power to 


ah 
.* 
«ad 
' 
| 
- 


data, and chart the results at lightning speed. 

“We like VX*REXX. Using it for development feels like 
driving a Porsche: it’s fast, it’s compact, everything’s 
in the right place, and it makes us look good, too.” 
Peter Coffee, PC WEEK 


Designed to Meet Your Needs. 


Watcom VX*REXX combines a project management 
facility, visual designer and an interactive debugger to 
deliver a highly productive visual development 
environment. The Client/Server Edition includes 
additional powerful objects so you can rapidly create rich GUI database 
applications. You can create OS/2 client applications which connect to 
DB2/2 or DB2/6000. Use IBM’s DRDA support on OS/2 to access DB2 for 
MVS, DB2/400 for AS/400, and DB2/VSE and VM (SQL/DS) for VM and 
VSE. Also supported are Watcom SQL and ODBC-enabled databases’. 
“Overall, this edition of VX*REXX for OS/2 is an outstanding visual 
client/server development platform.” Nicholas Petreley, InfoWorld 





access DB2 or other database systems, manipulate the 


* Over 2 dozen objects, * Easy to learn event- * Graphically create CUA’91 
including CUA'91 driven programming Presentation Manager 
containers, notebooks, model with complete objects, quickly 
pop-up menus and more = on-line documentation customize their properties, 

*|ntegration and control © *Supportfor professional and easily attach REXX 
of existing applications multi-threaded, multi- procedures 


through DDE, keystokes 
or REXX API's 


windowed and drag-and- 

drop enabled applications 
« Code reusability through 

section and file sharing 


« Package your application 
as an EXE or PM macro for 
royalty-free distribution 








Point. Click. And Presto! 


To create an application you draw user interface objects, customize their 
properties using standard OS/2 notebooks, and define their event code using 
powerful drag-and-drop programming. To add database access just draw a 
query object, visually design a SQL query, press OK and presto— your 
window is automatically populated with objects that are bound to your 
query to display, update and search your data. 

“Drag-and-drop nirvana.” Nicholas Petreley, InfoWorld 


Give Your Data a Whole New Image. 
Energize your applications by displaying your data in a 
3D chart. The Client/Server Edition gives you more than 
a dozen chart types to choose from, along with over 150 
display options. You also get complete support for run- 
time events so you can bring new drama to your data by 
making your chart interactive. 

“VXeREXX is a must buy.” Jacques Surveyer, 
Computer World 


Standard or Client/Server Edition— 

Which one is for you? 

To start creating powerful OS/2 GUI applications nght away, 3 
order your copy of Watcom VX*REXX Standard Edition for just....999 


Or, to start creating rich client/server database applications, , i 
order Watcom VX*REXX Client/Server Edition for just... $299 
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1-800-265-4555 Watcom 


A Powersoft Company 


Watcom Intemational 415 Phillip Street, Waterloo, Ontario, Canada N2L 3X2 Tel. (519) 886-3700 Fax (519) 747-4971 “Prices and specifications are subject to change without notice. Price does not include freight and taxes where applicable. Prices quoted in US doltars 
* ODBC drivers are available from INTERSOLV, inc. Watcom, the Lightning Device, and ViieRiexx are trademarks of Watcom International Corporation. Other trademarks are properties of their respective owners. Copyright 1994 Watcom Intemational Corporation. 


Circle Reader Service Number 3 





vie al Deborah Sommers 
SPECIAL PROJECTS 

Assistant Epitor Charles G. Frohman 
Regina Starr Ridley 

ara n@mfi.com 








(415)905-2256 
Christian O'Brien 


(212) 626-2322 

Claire Bright 

(415) 905-2544 

Marketinc MaNnacer Susan McDonald 

Marxetinc Grapuic Designer Siiari Flack 

Glenn Sadin 

CincuLaTion Director John Rockwell 
IRCULATION MANAGER Stephanie Blake 


U.S.: (800) WANT-OS2 
Foreign: (708) 647-5960 










Miller Freeman 


Senior Vice Presinent H. Verne Packer 
Semon Vice Present Donald A. Pazour 


Senior Vice Presivent Wini D. Ragus 
Vice PREsioeNT/PRooucTION Andrew A. Mickus 
Vice Presient/CircutaTion Jerry Okabe 





At, 


IN THE U.S.A. 









| NOVEMBER/(DECEMBER 








By DICK CONKLIN 


Serving 


Our Clients 


(Csr server development has been one of 
| our most popular themes since we started. 
And why shouldn't it? Downsizing is the 
theme of the ‘90s, and many a mainframe has 
yielded to a distributed network of desktop PCs 
and servers. There's no better C/S platform than 
OS/2. The popularity of client/server applications 
is also reflected in the best-selling computer books 
list. Our favorite examples are the books from Bob 
Orfali and Dan Harkey (you saw them here first, 
folks!). Bob and Dan (and Bob's wife Jeri) have an 
amazing talent for making complicated subjects 
easy to understand. If it takes little Martian cartoon 
characters to get a point across, that's fine with me! 

In this issue, we once again welcome Bob and 
Dan back to OS/2 Developer. You guessed it—here's 
an excerpt from yet another new book—their 
Essential Distributed Objects Survival Guide. 

While we're at it, let's welcome Steve Krantz to 
the ranks of client/server authors. Steve's article is 
taken from his new book, Real World Client/Server, 
an interesting commentary on one large corpora- 
tion's migration to a C/S platform. The company? 
None other than IBM itself. 

This issue completes our seventh year of pub- 
lishing this magazine. In 1996, you'll see some big 





Co 


changes, but no letup in the 
flow of practical articles 
about OS/2 application de- 
velopment. As always, we 
greatly appreciate your feed- 
back, your suggestions, your 
subscriptions, and of course 
your support. Don't be shy— 
we like to hear from you! 


Doh LL 
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This issue, our OS/2 Toolbox column reviews CCC/Manager 3.0.14. 
By GUY SCHARF 


CCC/ Manager 
for OS/2 





i‘! 


Guy Scharf 


onfiguration management consists 
of much more than simple version 
control and being able to recover 
prior versions. Softool Corp. has released 
CCC/Manager for OS/2 to address these 
needs. | reviewed the recently released ver- 
sion 3.0.1d. 

CCC/ Manager provides traditional 
version contro] features, with change and 
component management to allow access to 
historical versions of any file. But it also 
provides much more. Virtual configurations 
define multiple views of a project for differ- 
ent stages of a project, test, or production 
area, as well as any other view that you 
define. Packages group changes from multi- 
ple modules to a single unit that can now be 
migrated from development to test, release, 
or production status. Auditing and Access 
Control functions allow you to monitor 
activity and to ensure integrity of your soft- 
ware. CCC/Manager’s strength is its ability 
to manage change in a complex environ- 
ment, more than it is version control per se. 

CCC/ Manager stores version and con- 
figuration information in a database that by 





default reflects the directory structure of 


the project. While the database need not 
reflect the directory tree used for the projec- 
t’s source code, the default paths presented 
for different operations will be more useful 
if it does. When managing multiple prod- 
ucts, each should be in its own database to 
use CCC/Manager’s release mechanisms 
effectively. 

CCC/ Manager is licensed for the num- 
ber of users who will be logging into it. 
Concurrent licensing is available for larger 
installations. 


USING CCC/MANAGER 
[ installed CCC/Manager from two disks. 


Installation proceeded normally, except that 
the installation program demanded write 
access to the installation disk to update a 
DLL file. A 39-character license key, with a 
mixture of upper- and lower-case letters 
and special characters, has to be typed in 
during installation. CCC/Manager uses 
InstalISHIELD, with its well-known inabil- 
ity to handle long lines in CONFIG.SYS. 
The installation program detects this situa- 
tion and advises you to change PATH and 
LIBPATH manually. In my testing, | did not 
have to to make these changes at all. 

My first glimpse of CCC/Manager was 
inauspicious. I opened the demo database 
and was presented with three garbled win- 
dows. CCC/Manager’s main windows are 
implemented as dialogs with a menu and 
sizing border. This approach results in con- 
trols that overwrite the title bar and border 
if the dialog is sized smaller than its con- 
trols. Fortunately, this is easy to fix: simply 
resize the windows so that all the controls 
are visible within the windows’ borders, 
and then don’t adjust the window sizes 
again. 

Each time you start CCC/ Manager, 
you must login to the database with your 
user name and password, the fully qualified 
path to the database, your working direc- 
tory, and, optionally, the name of a configu- 
ration file. While CCC/Manager does not 
remember this information from one use of 
the program to the next, it does allow all of 
it to be specified on the command line. You 
can easily create a program object on the 
desktop, or a command file, with the 
required information passed as parameters. 

CCC/Manager has four main windows 
and a session log. From the File window, 
you can check in files and administer users 
and the database (Figure 1). Figure 2 shows 
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the Item window from which you can check 
out files, manage locks, create reports, and 
compare and merge files. The Configurations 
window lets you create and manage 
releases and phases (Figure 3). From the 
Packages window, you can define packages 
of changed modules to group changed 
modules together for migration and promo- 
tion. The Session log shows the result of 
most operations (Figure 4). 

Directories are shown in a tree view, 
using a custom CCC/ Manager control. This 
control is more compact than a container, 
and it works well. 

When you begin using CCC/ Manager 
for a project, first define your users and 
groups of users. Access control is extensive; 
more than 30 functions can be allowed or 
disallowed for a user working on a specific 
configuration. An audit log is optionally 
maintained, and you can specify which of 
six classes of events are to be logged. 

The power of CCC/Manager comes 
with its configurations that you create to 
represent a product life cycle. You must cre- 
ate a baseline configuration and load the 
application into the database for that con- 
figuration. Creating the baseline is easiest if 
your product is contained within a single 
directory tree. When you load the product 
into the database, CCC/ Manager records 
the current status of all modules and 
defines that as a baseline. Versions of files 
are recorded as forward deltas to reduce 
check-in time. With the baseline estab- 
lished, you can define other configurations 
that are derived from the baseline. For 
example, you might have separate configu- 
rations for development, test, and produc- 
tion versions of the product. It is easy to 
define these configurations and their rela- 
tionships to each other. 

Checking out and checking in of files is 
straightforward. You check files out using 
the items window and check them back in 
from the file window. By default, files are 
locked exclusively so that only one person 
may have a file checked out. You may 
change a database to use concurrent locking 
instead of exclusive locking. With concur- 
rent locking, several people may check out 
the same file. When you check the file back 
in, CCC/Manager will inform you if 
changes have been made since you checked 
it out. A merge tool will merge your 
changes with any other changes and then 
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Figure 2. tem window for file check-out. 


08-31-95 15:22:57 


Figure 3. Configuration window. 


i- Warning = cce2525: file iF: \ccom\sample\SRC\CIRCLE. Q is read-only 
Extracted and locked CIRCLE.C, version 1. 
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Figure 4. Session log. 
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give you the opportunity to review 
the combined file and edit any con- 
| flicts. CCC/Manager also supports 
version branching and duplicate 
directories as ways to accomplish con- 
current development. For long-term 
concurrent development projects, the 
better solution may be to define two 
development configurations, each 
derived from the same base configu- 
ration. These two configurations can 





then be merged to create a common, 
merged configuration for integration 
testing and later promotion to test 
and production status. 

Version and Change reports show 
a summary and detail of all changes. 
The output is written to the session 
log rather than being displayed in a 
window or file of its own. The session 
log can easily be written to disk for 
later review if desired. 

As files are checked in and pro- 
ject development progresses, you will 
eventually want to move some or all 
changes from the development to the 
test directory. CCC/ Manager allows 
you to group changes to multiple files 
together in a package. You simply 
select all the files to be included in the 
package by the change names 
assigned when the files were checked 
in. Once the package is complete, you 
can migrate the package to another 
configuration. From any configura- 
tion, you can promote a package to a 
source code directory tree. Promoting 
consists of extracting the source code 
for the files in the package and plac- 
ing it in the target directory tree. 
From there, you can recompile the 
configuration and confirm that every- 
thing still works. 

Eventually, you have a new 
release. You define the new release as 
a new baseline configuration and cre- 
ate new development and test con- 
figurations derived from it. Any 
pending changes from the prior deve- 
lopment and test configurations are 
merged forward into the new configu- 
rations, which replace the old ones for 
continued development. 

You might also want a configura- 


CCC/Managers strength is its 
ability to manage change in a 
complex environment 


tion for emergency fixes to the pro- 
duction version. It is easy to merge 
changes from the emergency fix con- 
figuration back into the development 
configuration so that they are inte- 
grated into the mainline code. 


DOCUMENTATION 

Documentation for CCC/ Manager 
consists of the 14-page CCC/Manager 
Installation Guide, the 80-page CCC/ 
Manager Primer, 
and the 290-page 
CCC/Manager User's 
Guide. The Primer 
takes you through 
creating a project, 
defining new con- 
figurations, check- 
ing in and checking 
out changes, pro- 
moting versions, 
and merging versions. While the 
Primer is written for the Windows 
product, I had little problem “men- 
tally” converting to the equivalent 
OS/2 windows. The icons are named 
slightly differently, and there are dif- 
ferences in the default actions and 
window layouts, but these did not 
interfere with learning how to use 
CCC/ 

Manager. 

The CCC/Manager User's Guide 
describes every function of the prod- 
uct in detail. I found the manual to be 
clearly written, and it was easy to find 
what I was looking for. 

The documentation explains con- 
figuration manage- 
ment well and in 
more detail than 
my brief summary. 
An accompanying 
white paper, titled 
Application Manage- 
ment: Using Virtual 
Configurations ex- 
plains the philoso- 
phy and application 
of configurations in 
more detail. 


WARTS AND BLEMISHES 

The documentation states that CCC/ 
Manager's windows are designed to 
CUA standards. It would have been 
better if this wasn’t stated—the win- 
dows violate CUA in many respects. 
Interestingly, the windows shown in 
the manual comply better with CUA 
than do the windows of the actual 
product. The problems are many; for 
example, mnemonics are used inap- 
propriately, and multiple selection 
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doesn't always do what might be 
expected. It appears that Softool 
intended the windows to be resizable, 
with the listboxes within the windows 
displaying more or less information. 
But this was not implemented, and 
the sizing border was left enabled. It 
would have been better to have dis- 
abled the sizing border, if Softool 
wasn't going to implement window 
sizing. These problems are irritating 
but do not seriously affect usability. 
Softool has said that it is addressing 
these issues. 

When you check in or check out a 
file, or perform other operations, you 
must examine the session log to deter- 
mine if the operation was successful. 
For most operations, no error window 
is displayed or bell sounded if the 
operation fails; you must watch the 
session log constantly. This approach 
is More reminiscent of exception 
reports from mainframe configuration 
management applications than it is of 
a good graphical user interface. 

The check-in window would be 
simpler if a filter was used to show 
just unchecked-in files. Without a fil- 
ter, you have to examine the entire 
directory to locate the files that are to 
be checked in. Both of these design 
issues will contribute to user error. 

Don’t close the Session Log win- 
dow. I couldn’t get it back without 
stopping and restarting CCC/ Manager. 
It's OK to minimize this window, 
though, 

CCC/ Manager will optionally 


CCC/Manager provides well- 
thought-out functions for 
managing versions and 
releases. 





insert the revision history or eight 
other pieces of information in the file 
as it is checked out. However, the 
comment delimiters for the revision 
history are defined for the database, 
not for the file extension. Thus, it may 
be difficult to include revision history 
on files that require a different com- 
ment delimiter than is used for most 
of the files in a project. 

Most windows are not refreshed 
automatically to reflect changes in 


directories or files. It would be more 
convenient if the lists in the windows 
were always maintained in their cur- 
rent form, even if changes were made 
outside of CCC/ Manager. 


LIMITS OF APPLICABILITY 

CCC/ Manager is designed for the 
company that wants to manage its 
products and control changes. It sup- 
ports multiple releases of products, as 
many phases (such as development, 
test, production) as your organization 
might want, client-customized ver- 
sions of products, and emergency fix 
configurations. Virtual configurations 
are the strength of CCC/Manager and 
can be applied to solve many configu- 
ration management problems. 

If you are looking for a program- 
mer’s version control tool, you proba- 
bly won’t like CCC/Manager. While 
command-line programs for check-in 
and check-out are provided, they are 
DOS programs requiring special DOS 
Settings. It may not be easy to inte- 
grate those tools with your editor or 
other development tools. 


TECHNICAL SUPPORT 

Technical support is available by tele- 
phone and e-mail. Softool has also cre- 
ated World Wide Web pages for a con- 
figuration management information 
center. Information articles are avail- 
able on basic configuration manage- 
ment principles, tips for implementing 
configuration management in an orga- 
nization, and lifecycle and process 
management. The configuration man- 
agement web page is located at http: 
/ /www.softool.com/CMCenter.html. 


SUMMARY 

CCC/Manager will appeal more to 
organizations that need to manage 
multiple versions of products or are 
ready to adopt a formal change man- 
agement strategy than to organiza- 
tions needing only simple version 


PRODUCT INFORMATION 


CCC/Manager for OS/2......$495 
Annual maintenance............ $85 


Vendor: Softool Corp. 

340 S. Kellogg Ave. 
Goleta, Calif. 93117 
Phone: (805) 683-5777 

Fax: (805) 683-4105 
Internet: info@softool.com 


control. I like CCC/Manager for man- 
aging projects. It provides well- 
thought-out functions for managing 
versions and releases as well as batch- 
ing changes. The availability of the 
product on diverse platforms should 
be attractive to installations managing 
projects that span several platforms. 
As a programmer, I would like 
better integration with my editors and 
other development tools to increase 
flexibility in checking out and check- 
ing in modules on an ad hoc basis 
during development. The user inter- 
face could be much improved by care- 


hg 
ij 


ful attention to Presentation Manager 
details and CUA guidelines. Softool | 
has said that an upgrade to address 
user interface issues and to add OS/2 
command line utilities will be 
released soon. I am looking forward 
to seeing these changes. 





Guy Scharf is president of Software Architects 
Inc., a software development firm specializing 
in developing OS/2 Presentation Manager 
applications for vendors and business. He can 
be reached at CompuServe 76702,557 or at 
Software Architects Inc., 2163 Jardin Dr., 
Mountain View, Calif. 
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This concludes your training in 


OO programming with VisualAge. 


No one’s debating the benefits of object- 
oriented programming. The only question is 


whether it’s worth the time and money it 


would cost to implement. 


With VisualAge? the question may be 
irrelevant. Because its simplicity can easily 


remove the barriers between you and the fast 


development of 
object-oriented 


applications. 


platforms, from PCs to the biggest servers. 
When your project is complete, you've 


created an application with industry-standard 


code (C++ or Smalltalk). And in a fraction of 


Can your software do this? 


the traditional development time, you're ready 
to deploy a true object-oriented application, 


with solid components that can easily be used 


over and over in 
future projects. 


Of course, your 


VisualAge is light years beyond mere GUI 


builders. It’s a graphical environment that takes 
you through the entire process, from interface 
design to working application. As InfoWorld 


puts it, “a masterpiece of visual programming.” 


With the C++ edition, you work with 


full OO solution requires even more. That's 
why IBM offers more OO products, consulting, 
education and services than any other software 
company. To quickly take advantage of OO 
technology, call 1 800 IBM-3333 ext. GA 070 


or visit http:// www.software.ibm.com. You'll 


“parts” from IBM’s Open Class 
Library, creating visual links 
between them. They’re easy to 
modify and compliant with stan- 


dards, so they can be used across 





find that you ve been in training for 


VisualAge all your life. 
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veryone is affected by the bitmap, 
yet most of us really don’t under- 
stand how they work or are con- 
structed. Various bitmap formats are defined 
within OS/2 to the extent that they seem con- 
voluted and complicated. To compound 
things, there is a form of bitmaps that is effec- 
tively an array of images. 

Over the next few issues, we will jump 
paws-first into bitmaps to try to learn how 
they are defined, how we can display them 
directly from bitmap files, and how to manip- 
ulate them and perform some really neat 
tricks with them. Along the way, we will try 
to explain some of the more mysterious 
details of bitmaps, such as ROPs. 

So, where do we begin? How about we 
look to the origin of bitmaps? 





A QUICK HISTORY LESSON 

In the beginning, there were two types of dis- 
plays used for interactive graphics. One was 
the random-scan vector display. This display 
type can be thought of in a similar fashion to 
that of the plotter. Using vector-type com- 
mands, it would draw lines and arcs on a 
cathode-ray tube. You would only need to 
give the display a starting point and an end- 
ing point, and it would draw the line. 

The second type, the raster-scan display, 
became the more prevalent type. The raster- 
scan display can be thought of in a similar 
fashion to the dot-matrix printer. Information 
is recorded on a dot-by-dot basis. These dots 
are commonly known as pixels. 

The major difference between the two 
display types is that the vector display con- 
tains only the information regarding the 
starting and ending points of lines and char- 
acters with the middle or void areas being 
ignored, whereas the raster display is respon- 
sible for each element (point) that constitutes 


each line or character. Therefore, much more 
information needs to be recorded by the 
raster display than by the vector display. 

So, why the raster vs. the vector? Two 
real reasons. The need for a realistic display 
of images played heavily in favor of the 
raster display since it could display a three- 
dimensional image with greater ease than the 
vector display. The second reason was cost. 
Initially, the high cost of raster displays was 
due to the large amount of memory required 
because each addressable pixel required 
memory to record its state. A larger amount 
of memory was necessary to store the infor- 
mation within a raster display than a vector 
display. However, the costs dropped, and the 
raster scan display prevailed. 


INTO THE HERE AND NOW 
What is a bitmap? Well, as the name sug- 
gests, it’s a map of bits. Yeah, right... 

Just like a geographic map, each relevant 
item within that map describes a location. 
Los Angeles has a location of 34 0’N 118 
10’W, whereas London ts 51 30’N 0 5’W. You 
cannot transpose these two locations. 

Bitmaps are similar. A pixel, which is 
defined for location, cannot be transposed 
with a different pixel in a different location. If 
you do transpose them, the meaning of each 
would be different. 

Bitmaps as we know and use them today 
really just describe a color at a particular 
location. When the colors are combined, we 
interpret them through the mechanics of the 
eye and then apply meaning to what we see. 


BITMAP CONCEPTS 

Essentially, the bitmap is a record of the color 

of a particular pixel position. With raster dis- 

plays, this is 2, 16, 256, or 65,536 (64K) colors. 
Many different schemes can be created 
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to record this pixel, and, essentially, the 
bitmap under OS/2 is one of those schemes. 
To make things more difficult, how do you 
ensure that a given bitmap can work on the 
different display types, with different capa- 
bilities and resolutions? 


DEVICE INDEPENDENCE 

The structures that are used within OS/2 to 
describe bitmaps have been designed with as 
much device independence as possible. 
During the days of OS/2 1.1, there was a sim- 
ple bitmap definition. This definition defined 
the bitmap for a given device, which meant 
you had to create different bitmaps for each 
of the resolutions handled. Then, you had to 
save these bitmaps within the applications’ 
resources using different IDs. Finally, at run- 
time, you had to determine the resolution 
you were dealing with and then pick the 
appropriate bitmap image from the applica- 
tions’ resources. Seemed like a lot of work. 

Beginning with OS/2 1.2, the design 
goal of the bitmap was device independence 
so that one bitmap could contain different 
images of the bitmap, thus allowing the 
image that was appropriate for a given 
device to be selected. 

Now you know why the bitmap appears 
to be so difficult. Instead of creating two, 
three, or four images of a bitmap for a set of 
different resolutions, you could create one 
bitmap (known as a bitmap array) that con- 
tained the different images for the different 
resolutions. Then, inside your PM applica- 
tion, you would only need to select the one 
bitmap through GpiloadBitmap, and the system 
would figure out which of the images in the 
bitmap array would suit the particular dis- 
play on which the application was running. 

And to make life more fun, the struc- 
tures that were introduced in OS/2 1.2 were 
revised and expanded for OS/2 2.0. (All of 
the necessary structures for both OS/2 1.x 
and 2.x are contained within the PMBIT- 
MAP.H header with the 2.x structures ending 
with a 2.) 

Part of these changes were supposed to 
make it easier to create device-independent 
bitmaps, but some changes really are not 
very effective. 


THE STRUCTURE OF A BITMAP 

The simplest OS/2 bitmap consists of a struc- 
ture, BITMAPFILEHEADER or BITMAP- 
FILEHEADER2, a color table, and the image 
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data. Listing 1 shows the structure values for 
the bitmap image of Figure 1. 

Basically, the structure describes the 
bitmap through a series of fields. The most 
important fields to pay attention to are con- 
tained in the BITMAPINFOHEADER or BITMAPINFO- 
HEADER2 portion of the structure. The cx, cy, 
and cBitCount fields are used to describe the 
width and height of the bitmap and the num- 
ber of colors in it. The cBitCount field defines 
the number of bits defined by each pixel posi- 
tion within the image data. 

The following table depicts the number 
of colors as defined by cBitCount: 


a rr 
BITMAPFILEWEADER? bfh2: 
USHORT usType = BFT_BMAP 
ULONG cbSize = 78 
SHORT xHotspot = 25 
SHORT yHotspot = 25 
VLONG offBits = 142 
BITMAPINFOHEADER? bfh2. bmp2: 
ULONG cbFix = 64 
ULONG cx = 50 
ULONG cy = 50 
USHORT cPlanes =] 
USHORT cBitCount = 4 
VLONG wlCompression = BCA_UNCOMP 
ULONG cbImage =0 
ULONG cxResolution = 0 
ULONG cyResolution = 0 
ULONG cclrUsed =0 
USHORT usUnits = BRU_METRIC 
USHORT usReserved = 0 
USHORT usRecording = BRA_BOTTOMUP 
USHORT usRendering = BRH_NOTHALFTONED 
WLONG cSizel = 0 
WLONG cSize? = 0 
ULONG ulColorEncoding = BCE_RGB 
ULONG ulIdentifier = 0 


argbColor[ 0] = 0x00000000 
argbColor[ 1] = 0x00000080 
argbColor[ 2] = 0x00008000 
argbColor[ 3] = 0x00008080 
argbColor[ 4] = 0x00800000 
argbColor[ 5] = 0x00800080 
argbColor[ 6] = 0x00808000 
argbColor[ 7] = = 0x00808080 
argbColor[ 8] = = Ox00cccece 
argbColor( 9] = 0x000000Ff 
argbColor[ 10] = 0x0000ff00 
argbColor[ 11] = Ox0000ff ff 
argbColor[ 12] = 0x00Ff0000 
argbColor[ 13] = Ox00FFOOTF 
argbColor[ 14] = Ox00f fF F00 
argbColor[ 15] = Ox00ffffff 


Listing 1. Bitmap structure values. 
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Figure 1. Sample bitmap image. 


cBitCount colors 
2 2 

4 16 

8 256 

16 65,536 


The easiest way to determine the 
number of colors is to take the value of 
the cBitCount and rotate it left 16 posi- 
tions: 


ccolors = bfh2.bmp2.cBitCount << 16 


If the number of colors for the 
bitmap are 256 or less, an RGB color 
table resides immediately after the 
BITMAPFILEWEADER or BITMAPFILEHEADER2 
structure. It will contain either 2, 16, or 
256 entries depending on the cBitCount 
value. 

If the bitmap is a 64-K color 
bitmap, each item within the bitmap 
data is an RGB value. 

So why the difference? Quite sim- 
ply, because space is required to record 
the image. And, consequently, this is 
another area that makes the decoding 
of the actual bitmap data interesting. 

The easiest (and also most diffi- 
cult) way to understand this is to look 
at the actual image data for the various 
color types supported. Here we will 
look at a three by three image in 2, 16, 
and 256 colors as well as 64-K color 
representations (Figure 2). To conserve 
space and also make the examples eas- 
ier, we are using the OS/2 1.x structure 
definitions. Each square in Figure 2 
represents a pixel. 

As you look at each of the struc- 
ture definitions, you will really only 
notice a few changes between each of 
them. The offBits element will differ as 
a result of the color table between the 
structure and the image data. The 
cBitCount field will contain the appro- 
priate value for the bitmap defined. 
Other than that, the values are the 
same within the structures. 
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As would be expected, the color 
table information will be different for 
each of the different bitmaps. And 
finally, the image data itself will be 
different. 

For the two-color bitmap, the 
header is: 


BITMAPFILEWEADER bfh: 
USHORT usType = BFT_BMAP 
ULONG cbSize = 26 
SHORT xHotspot = 1 
SHORT yHotspot = 1 
ULONG offBits = 32 
BITMAPINFOHEADER bfh.bmp: 
ULONG cbFix = 12 
USHORT cx =3 
USHORT cy =3 
USHORT cPlanes = 1 
USHORT cBitCount = 1 
argbColor[ 0) = 0x00000000 
argbColor[ 1] = Ox00ffffff 


The image data is: 
A00000004000000040000000 


For the 16-color bitmap, the header 
looks like: 


BITMAPFILEHEADER bfh: 
USHORT usType = BFT_BMAP 
ULONG cbSize = 26 
SHORT xHotspot = 1 
SHORT yHotspot = 1 
ULONG offBits = 74 
BITMAPINFOHEADER bfh.bmp: 


ULONG cbFix = 12 
USHORT cx =3 
USHORT cy =3 


USHORT cPlanes = 1 

USHORT cBitCount = 4 
argbColor[ 0] = 0x00000000 
argbColor[ 1] = 0x00000080 
argbCoLor[ 2] = 0x00008000 
argbColor[ 3] = 0x00008080 
argbColor{ 4] = 0x00800000 
argbColor[ 5] = 0x00800080 





Figure 2. Three by three bitmap image. 
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argbColor[ 6] = 0x00808000 
argbColor[| 7] = 0x00808080 
argbColor[ 8] = Ox00cccecc 
argbColor[ 9] = 0x000000Ff 
argbColor[ 10] = 0x0000Ff00 
argbColor[ 11] = Ox0000ffff 
argbColor[ 12] = 0x00ff0000 
argbColor[ 13] = Ox00ffOOff 
argbColor[ 14] = Ox00ffff00 
argbColor[ 15] = Ox00ffffff 


and the image data: 
FOFO00000F000000F0F00000 


The 256-color bitmap header looks 
like (there are 256 items for the color 
table, only a few are shown here): 


BITMAPARRAYFILEHEADER : 
USHORT | ustype = BFT_BITMAPARRAY 
USHORT. cb6ize = 40 
USHORT of fWext = 0 
| UBHURT., cxDigplay = 1024 
SHORT.’ cyDisplay = 768 
BITMAPFILEHEADER bfh: 
USHORT usType = BFT_BMAP 
ULONG cbSize = 26 
SHORT  xHotspot = 1 
SHORT  yHotspot = 1 
ULONG offBits = 908 
BITMAPINFOHEADER bfh. bmp: 
ULONG cbFix = 12 
USHORT cx = 3 
USHORT cy =3 
USHORT cPlanes = 1 
USHORT cBitCount = 8 
argbColor[ 0] = 0x00000000 
argbColor[ 1] = 0x00000080 
argbColor[ 2] = 0x00009200 
.. argbCoLor [254] = Ox00f7f7f7 
argbColor[255] = Ox00ffffff 


OFOOOFOO000FO0000FO00F00 
Finally, for the 64-K color bitmap: 


BITMAPARRAYFILEHEADER ; 
USHORT usType = BFT_BITMAPARRAY 
USHORT cbSize = 40 
USHORT offNext = 0 
USHORT cxDisplay = 0 
USHORT cyDisplay = 0 
BITMAPFILEHEADER bfh: 

USHORT usType = BFT_BMAP 
ULONG cbSize = 26 
SHORT  xHotspot = 1 

SHORT yHotspot = 1 
ULONG offBits = 140 
BITMAPINFOHEADER bfh.bmp: 


ULONG cbFix = 12 
USHORT cx =3 
USHORT cy =3 


USHORT cPlanes = 1 
USHORT cBitCount = 24 
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Figure 3. Bitmap viewer. 


and the image data: 


FFFFFFOOOOQOFFFFFFO00000 

000000FFFFFF000000000000 

FFFFFFOOOQOOFFFFFFO00000 

So what's the big deal? The magic 
of completing the bitmaps’ interpreta- 
tion lies within the image data itself. 
What the data represents (except for 
the 64-K color bitmaps) is an index into 
the RGB color table for the pel position. 

Consider a 16-color bitmap. It will 
have a color table of 16 elements. 
Therefore, if we had: 


579 
138 
642 


the first pel would be RGB[5] and the 
second pel would be RGB[7]. 

This is the concept; the trick lies in 
the actual representation within the 
bitmap. What this really means is that 
depending on the number of colors, the 
index position is defined differently. 

For the two-color bitmap, the 
image data is (we are showing it in row 
format to make it easier to see how the 
data eae to the image): 


40000000 


40000000 


When you look at this, you'll find 
it difficult to understand the data. Each 
row (or scan line) within the bitmap 
data (and this applies to all bitmap 
data) must begin on a 32-bit (ULONG) 

A two-color bitmap index is very 
simple. There are only two index val- 
ues, 0 and 1. Therefore, each of the bits 
for the two-color bitmap consists of a 
series of bit index values. By changing 
the above to binary, you get for each of 
the rows: 





kitty.BMP iOS/2 , 





See the pat- 
tern? Each byte 
|| would then con- 
tain eight pel in- 
dex values. 

The 16-color 
bitmap operates 
in a fashion that 
is similar, only 
this time it looks 
like: 


¢ format] | 


FOFO0000 
0F000000 
FOFO0000 


Here, each RGB index is repre- 
sented by a nibble (4-bits) instead of a 
bit. 

A 256-color version of the bitmap 
looks this way: 


OFOOOF00 
000F0000 
OFOOOFO0 


using each byte as the index to the RGB 
color table. 

Finally, the 64-K bitmap represents 
each pel with the RGB color value 
(each RGB colors is 3-bytes): 


FFFFFFOOQQOOFFFFFFO00000 
000000FFFFFF000000000000 
FFFFFFOOOQOOFFFFFF000000 


With this now under our belts, it is 
time to look at how we can use this 
information. How about a bitmap 
viewer? 


A BITMAP VIEWER 

One of the best ways to understand 
bitmaps is to build a viewer that can 
read in a .BMP file from disk and dis- 
play it. Figure 3 shows the bitmap 
viewer in action. 

Through the File Open menu item, 
you can pick a bitmap file to display. 
This file is then read in from the disk 
and interpreted (yes folks, the opera- 
tive word here is interpreted). 

Due to the history of bitmap evo- 
lution under OS/2, you'll need to 
structure the bitmap code to interpret 
the information that is being read. 
Because there are two different bitmap 
types, 1.x and 2.x, you'll need to inter- 
pret various header information to be 
able to know how to correctly reference 
the data contained. 

Further, the bitmap can either be 
a single image or an array of images, 
which complicates things even more. 
Oh yeah, Windows bitmaps are simi- 
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lar, but, alas, the header information is 
different. 

So, what have we done to handle 
this? Basically, we read in the entire 
image from the disk into a buffer of the 
appropriate size. Assuming the image 
is an OS/2 bitmap, it can start with one 
of two structures: BITMAPARRAYFILEHEADER 
or BITMAPFILEHEADER for OS/2 1.x type 
bitmaps, or BITMAPARRAYFILEHEADER2 or 
BITMAPFILEHEADER2 for OS/2 2.x bitmaps. 
The first element in each is usType. The 
second element is cbSize. It is these two 
elements that you should interrogate. 

To determine if you are dealing 
with a BITMAPARRAYFILEHEADERx, check to 
see if usType is BFT_BITMAPARRAY, which if 
true means you need to interpret the 
data using the BITMAPARRAYFILEHEADERx 
structure. Each bitmap will be defined 
using this structure, and the means of 
walking through the structures from 
one to the next is by checking the value 
of offNext. When this value is 0, you 
have reached the last image within the 
array. 

If the value contained within the 
usType element is BFT_BMAP, you are deal- 
ing with a BITMAPFILEHEADERx type of 
structure. 

To determine whether or not the 
structures are 1.x or 2.x types, check 
the values of the cbSize elements. If 
you are dealing with a 1.x type of 
structure, this element will contain the 
value of 


sizeof (BITMAPFILEHEADER) 


By checking the size in cbSize, we 
can determine whether we should use 
the 1.x or 2.x structures. 

What this really means is that we 
use similar code to interpret the infor- 
mation read in from the disk, except 
that one routine understands 1.x image 
information and the other understands 
2.x image information. 


STACKING THE ODDS 

In our routines, we build a stack of 
images based on the bitmap array data. 
If the bitmap only contains one image, 
we only have one image within our 
stack. This will allow us to display 
whichever image is appropriate. 

Figure 4 shows the bitmap viewer 
with the images from a bitmap array 
bitmap. It also shows the pop-up menu 
that is displayed when you click button 
2 mouse over the image. This pop-up 
menu allows you to select the informa- 
tion to view for the image. 

When you have selected one of the 
pop-up menu items, the information 
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Figure 4. Bitmap viewer showing images from array. 


displayed, like that in Figure 5, is taken 
from the bitmap structures. 

When you select the pop-up menu 
item for the color table, the View Color 
Table dialogue (Figure 6) will allow 
you to edit the color table entries. 


SO WHICH IS THE RIGHT ONE? 

A further dilemma revolves around the 
bitmap array. The question that is 
always asked is, “Which image do I 
pick?” 

The trick with the bitmap is to 
know how to interpret the header 
information. For the bitmap array 
shown in Figure 4, the following 
depicts the format of the file: 


image 1: 50 x 50 x 16 colors 
BITMAPARRAYFILEHEADER2 
BITMAPFILEHEADER2 
BITMAPINFOHEADER2 

RGB[16] 

image 2: 25 x 25 x 16 colors 
BITMAPARRAYFILEHEADER2 





Figure 5. Bitmap structure contents. 
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BITMAPFILEHEADER2 
BITMAPINFOHEADER2 

RGB[16] 

image 3: 50 x 50 x 2 colors 
BITMAPARRAYFILEHEADER2 
BITMAPFILEHEADER2 
BITMAPINFOHEADER2 

RGB[2] 

image 4: 62 x 62 x 256 colors 
BITMAPARRAYFILEHEADER2 
BITMAPFILEHEADER2 
BITMAPINFOHEADER2 

RGB[256] 

image 1 data 

image 2 data 

image 3 data 

image 4 data 


In the bitmap viewer, you will 
notice that when you pick a bitmap ini- 
tially, even if it is a bitmap array, only 
one image is selected. 

The best way to explain this is to 
understand how and why the Icon 
Editor constructs bitmap arrays. The 
previous example 
depicts four images 
contained within the 
bitmap file. The first 
image—50 by 50, 16 
color—is the default 
image. What this 
means is that if none 
of the other images 
are designed for the 
display type, this one 
is used. It is also sup- 
posed to correspond 
to a VGA type of reso- 
lution, or, as de- 
scribed by the Icon 
Editor, Independent 
Color Form (=VGA). 
This format is other- 
wise known as low 
res. The second image 
is a _ special-case 
image. It is described 
by the Icon Editor as 
Small Color Form. It 
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is 25 by 25, 16 color, which is exactly 
50% of the size of the Independent 
Color Form image. 

The third image is defined by the 
Icon Editor as Independent BW Form 
(1.1). It is 50 by 50, 2 color—the same 
size as the default image but with only 
two colors. 

Finally, the last image is defined 
by the Icon Editor as 8514. It is also 
known as high res. It is 62 by 62, 256 
color, which is 125% larger than the 
default image, as it is intended for dis- 
plays that are 1,024 by 768 or higher 
resolution. 

Now what? How do we use this 
info to determine how to pick the cor- 
rect bitmap? Look at the BITMAPARRAY- 
FILEHEADERx fields cxDisplay and cyDis- 
play. If these fields are greater than 0, 
they will contain the resolution for 
which the image was intended. If the 
image is high res, the cxDisplay ele- 
ment will contain 1,024 and the 
cyDisplay element will contain 768. If 
the display on which you are present- 
ing the image is at least this resolu- 
tion, you would use this bitmap array 
image. 

Alternately, if the image is a 2.x 
style image, you could try to use the 
cxResolution and cyResolution ele- 
ments of the BITMAPINFOHEADER2 to match 
display resolutions. This value, in the- 
ory (and the very operative word here 


Figure 6. View color table dialogue. 
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is theory), would be checked against 
the value contained in CAPS_HORIZON- 
TAL_RESOLUTION and CAPS_VERTICAL_RESOLU- 
TION from the DevQueryCaps API. Why the- 
ory? Well, simply put, no two different 
adaptors define the metrics in a similar 
fashion. Also, the display drivers may 
simply use a given model (that is, 1,024 
by 768 while displaying in 1,280 by 
1,024 resolution). 

So, where does this leave us?— 
Low res and high res. Low res can be 
thought of as anything below 1,024 by 
768 resolution and high res as being 
1,024 by 768 and above. 


THE REST OF THE VIEWER 

What else does the viewer do? Well, in 
this version, it scales the bitmap 
images, displays device information, 
and allows you to flip the color table 
around. Why? Basically, to show you 
how to manipulate the bitmap once it 
has been read in from the disk, 

If we wanted to, we could manip- 
ulate the image data. It wouldn’t be too 
difficult to take an image and invert it. 
All you have to remember is how the 
index values are recorded. 

As an added bonus, the bitmap 
viewer can read in a Windows bitmap 
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and display it as though it were an 
OS/2 bitmap, even though the header 
information for Windows bitmaps are 
different. 


NEXT TIME 

Next time, we will discuss that thorny 
issue of ROPs. They really are quite 
simple once you understand the 
basics. 
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In this issues Programming Insider, you will see how you can take advantage of the 
power of the workplace shell, use DLLs to reduce the amount of work in an application, 
and also minimize the amount of code you have to write and debug. 

By DAVID E. REICH 


n the classic programming and usage 
model, users start a program, open a 
data file, manipulate the data and then 
save and/or print the file. This is an applica- 
tion-oriented approach. The application is the 
center of the user’s focus, having to be 
launched, fed, and maintained. 

Object-oriented, on the other hand, is 
more than just putting objects in folders on 
the desktop and having objects represent 
your printers and other desktop tools. 
Object-oriented is also a way of thinking and 
a way of having users interact with the vari- 
ous parts of the computer. 

In the application-oriented world, all 
you had to do was ensure that your applica- 
tion could be started from the shell, and you 
were done. Now, when users are as comfort- 
able working with computer objects as they 
are with real objects, you need to change 
your way of thinking about the programs 
you write. You need to look at making your 
program a part of the computer system, not 
just something to be started and used. 

To accomplish this, begin thinking 
about the documents or other objects that 
you want to manipulate (database records, 
files, graphs, or sets of data). Think of the ob- 
jects as the operands and the application as 
the operator, to use mathematical terms. 
From now on, users no longer start applica- 
tions, they open objects. The objects are sim- 
ply presented to them in the way in which 
they are accustomed to seeing them. If it is a 
graph object, it is presented in their graphing 
program. If it is a database file, it is pre- 
sented in their database program or transac- 
tion processor, or whatever program they 
use to manipulate their data. 

This presents challenges in writing ap- 
plications, and more precisely, object manip- 
ulators. These challenges arise in how you 





Drag Me, Drop Me, 
Treat Me Like an Object 


will use function and how you will architect 
it to be efficient and flexible. 

In the past, I’ve written about not writ- 
ing your application as an object but writing 
an object class (or classes) to represent the 
different types of data you might want to 
store. I’ve discussed the merits of reusable 
code and using DLLs for a purpose. This 
subject lends itself very well to such coding 
practices. 


OBJECT-ORIENTED PRINTING 

Let’s first start with a straightforward sub- 
ject: printing. Users of application-oriented, 
graphical software look to the menu bar for 
the File and Print menus. From there, one 
sees some dialog with which to select print 
destinations, paper orientation, and other at- 
tributes and then a push button that says Go, 
Print, or OK. The print job is on its way, as 
long as the user knows the printer name, 
some of its capabilities, and other tidbits of 
information that the dialog window might 
require. The user also needs to start the ap- 
plication, feed it a data file, and tell it where 
to put it. This is a lot of work to enable a user 
just to take an existing piece of data and put 
it on a printer. 

In the object-oriented world, the user 
knows which folder holds the desired data. 
The user opens the folder, sees the object 
that represents this data, and drags and 
drops it on the printer. The user is then pre- 
sented with a window that has some prede- 
fined values for paper orientation and such, 
and if no changes are desired, the user says 
OK and the job is off to the printer. The user 
never sees or knows about an application. 
The user only knows that (s)he wanted a 
piece of data printed, dragged and dropped 
it there, and it happened. 

As I wrote last year in my two-parter on 
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“InSOMnia and Workplace Shell Pro- 
gramming” (May/June and July/August 
1994), writing an object class to represent 
your documents or data files is not terribly 
involved. It does, however, require SOM 
programming and takes advantage of the 
Workplace Shell programming model. The 
point of this column is not to rehash what 
you ve already seen but to expand on it. 

To recap, your task is to enable drag- 
and-drop printing. The system (Workplace 
Shell) default behavior can only print plain 
text or printer-specific files, because OS/2 
cannot, and should not, be expected to know 
about all of the data file formats that all of 
the available applications support. To sup- 
port graphical printing through the device 
independence afforded by OS/2, the origina- 
tor of the print job must be able to create a 
presentation space and a device context, and 
play or paint the data into the presentation 
space. To do that, the application must also 
know the data format so it can decipher it 
and draw it appropriately. 

Given that the shell cannot be expected 
to know your applications’ data format, you 
can force the user to open the application, 
open the data file and choose File, Print, and 
go through the application-oriented way of 
doing things. Or you can provide a way for 
the user to drag and drop a document on a 
printer and eliminate a lot of work. To ac- 
complish this task (assuming you do not 
store your data file as plain text or printer- 
specific, in which case your work is already 
done), you will write an object class, most 
likely as a subclass of the Data File class 
(WPDataFile) . 

If all you want to do is enable drag- 
and-drop printing, you can override some 
basic methods to give yourself a type and 
an icon along with wpPrintObject. The 
wpDataFile class’s behavior for wpPrint0bject 
is to put up the “which type of file” dialog 
and then act accordingly, either creating a 
presentation space and device context and 
drawing the data, or passing it straight 
through with no translation (for printer- 
specific files.). You, however, will be over- 
riding vpPrint0bject and doing something 
different. 


NOW FOR SOMETHING COMPLETELY DIFFERENT 
When an object is dropped on a printer, it 
gets called at the upPrintObject method. If the 
class that the object belongs to does not han- 





dle or override wpPrintObject, the method call 
is passed to the parent of that class, and so 
on up the chain until it hits a class that han- 
dles it. In the case of WPDataFile, that class 
handles the method call if the subclass does 
not. What you are doing is defining behavior 
different from the WPDataFile class’s behavior 
for wpPrintOb ject. 

When your object is called at wpPrint- 
Object, it needs to take action to print the 
data object on the printer specified. First off, 
you are given the printer destination and a 
pointer to the object that is to be printed. In 
fact, the method call gives you the entire 
data structure needed to call DevOpenDC to cre- 
ate a printer device context. All you need to 
do is figure out how to take the object 
pointer and get the data from the object and 
interpret it. 

To get the name of the data file that the 
dropped object represents, you can call 
wpQueryRealName. This will give you the file 
name for the file you need to print. Now you 
can see how to use the power of multithread- 
ing, code sharing, and the Workplace Shell. 

At this point, you have been called at 
wpPrintObject, you are executing inside the 
code that you have written to override this 
method in your object class, and you have a 
print destination structure and a file name. 
You could simply call DosExecPgm or DosStart- 
Session to start your application, pass in a 
flag such as "/p" to specify starting it up in 
invisible print mode, and pass in the print 
destination structure and the file name with 
code in the application to handle it—but that 
is the quick and dirty way. There is a much 
more elegant way to accomplish this, with 
much less overhead and much more reuse of 
code. 

Starting a whole new session or process 
is a high overhead proposition. Most users 
are running in a memory-constrained sys- 
tem, no matter how much they have, and 
that much overhead just to print a file is very 
undesirable. 

Rather than take you through the baby 
steps of a more elegant implementation, I'll 
just jump right into it. Use DLLs for your 
printing functions. DLLs are primarily used 
to share code between processes. You may 
say that your program is only one process. 
Remember, however, that your object classes 
run in the Workplace Shell's process. 

If you take the “ugly” approach and 
start the application to print the file, you are 
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incurring all of the overhead associ- 
ated with starting the process or ses- 
sion. By using DLLs for your print 
function, you can call it from the appli- 
cation when needed, or from another 
process such as the Workplace Shell 
process (and not load the code until or 
only if you need it). Let’s look at the 
mechanics. 

In a DLL, you write functions. It is 
not an executable program per se, but 
a library that contains functions and is 
callable by multiple processes. It is in 
this DLL that you can write the print 
handler. It will have one externalized 
entry point, such as MyPrintFunction. In 
this function you can accept the print 
destination structure you received 


You must be aware of the 
effects you have on the 
rest of the users com- 
puter when you add your 


code to the system. 


from the wpPrintObject call, also with 
the real file name you received from 
wpQueryRealName in the wpPrintObject 
override in your class. This function 
will be called either from the applica- 
tion if it is running or from the object 
class that represents your data files. 
This is the consistent interface to your 
print function. 

Inside this function, you will cre- 
ate the printer device context and pre- 
sentation space using the print destina- 
tion structure provided, pull in the 
data file, interpret it, and draw it to the 
presentation space. You also have the 
option of calling DevPostDeviceModes for 
the printer to offer the user the option 
of changing some of the printer de- 
faults. 

Since this is your program, you 
can write it to interpret the data file 
format and work with it. You could 
also do this in the object class, but why 
have the code in the application and 
the object class, too? If you make a 
change to one, you must also change 
the other. Dual maintenance is some- 
thing we try to avoid. 

To enable all of this, simply export 
MyPrintFunction from the DLL, and cre- 
ate a .LIB file for the DLL. You will use 
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this .LIB file to link the application as 
well as the object class to be able to call 
MyPrintFunction. Once there, a call to the 
function will resolve to your DLL and 
you can print without the overhead of 
another process or session—just a 
function call from your object class 
into some shareable application code. 


WHAT ABOUT THREADS? 

I’m sure by this time you're asking 
about threads. This is especially im- 
portant when using this method of 
printing as opposed to doing it in the 
application, because when printing 
from the object using drag and drop, 
you are executing MyPrintFunction in the 
Workplace Shell's process, and, hence, 
using its threads. If you sim- 
ply had single-threaded 
code in your application, 
shame on you. If you use the 
Shell’s thread and hold it for 
the duration of the print job, 
double-shame on you. 

You could start a thread 
in the application before you 
call MyPrintFunction and just 
call it on this new thread, 
and you could do the same 
in the object class you write. 
This solves the problem. 
However, it again gives you 
double code. It would be 
easier and more efficient to call 
DosCreateThread right inside MyPrint- 
Function. You could then immediately 
return control to your caller and pro- 
cess the printing on this new thread. 

Using this method, you create a 
thread only in one place and have only 
one set of code to maintain and debug. 
If you decide to write more applica- 
tions, you can use this utility, or per- 
sonal print library in all of them with- 
out having to code extra thread 
creation or other overhead each time, 


FINE TUNING 

There is one other bit of fine tuning | 
need to touch on before you begin 
writing the code to exploit these fea- 
tures. This should also give you some 
food for thought when you write any- 
thing to do with DLLs. Go back a little 
bit and reread the part about the .LIB 
files for your DLL. Notice anything in- 
teresting there? 

Recall the fact about DLLs that 
have functions that other programs 
use and import by name using the .LIB 
file. The fix-up record in the executable 
code or other DLL is stored in the 
header of the EXE or DLL. Because 
when that module loads, the fix-ups 
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must be performed. If you call 
MyPrintFunction by name in your object 
class, then whenever an object belong- 
ing to your class is opened (which will 
hopefully be often since you will not 
only write the class for printing, but 
for full object-oriented function with 
the application) the print DLL will be 
referenced and loaded if it is not al- 
ready. This is more overhead than you 
need, especially if the user has no in- 
tention of printing the data object. 

The function can be called by ad- 
dress, using DosLoadModule and rather 
than by name. By using this method, 
you delay loading the code until you 
really need it, rather than loading it 
just because the module that refer- 
ences it has been loaded. 

There is nothing wrong with call- 
ing it by name and linking with the 
-LIB file when it comes to the applica- 
tion (if you still want to provide the 
user a File, Print menu option), but 
there’s no reason to have the 
Workplace Shell load your DLL just 
because your document object class 
has been instantiated. These are the 
things you need to think about in cod- 
ing this advanced function and how to 
gracefully cooperate with the system 
functions. 

So, you've now seen a really con- 
crete example of using DLLs for more 
than just sharing code among pro- 
cesses of your own application. This is 
just the tip of the iceberg in what you 
can do with the functions provided by 
O5/2. As you saw in the final tuning 
and thread tips, you must also take 
care in how you use the system re- 
sources and be aware of the effects you 
have on the rest of the user’s computer 
when you add your code to the sys- 
tem. That is just what you will be 
doing in the new “seamless” world: 
making your application a part of the 
user’s computer, not just something to 
start, stop, feed, and maintain. 
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Performance 0S/2 Warp Applications, pub- 
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fter all of the planning for a cli- 
ent/server migration is complete, 
there comes a point when you actu- 
ally give the users some computers and say 
go. This is the office client rollout. Careful 
planning must be performed prior to and 
during an office client rollout to guarantee 
user satisfaction. This article details the IBM 
Boca Raton, Fl. experience during a large- 
scale client/server migration in 1993-1994. It 
will focus on the office client rollout, detail- 
ing requirements, the transition to client/ 
server computing, and some critical success 
factors. Although this focuses on the Boca 
experience, most of the activities can be gen- 
eralized and applied to your client rollout. 

The office client probably impacts the 
bulk of the users and should receive the 
greatest attention throughout any client/ 
server migration project. In Boca, over 2,700 
computer systems fit this category. An office 
client is a PC with e-mail, calendar, phone 
directory, network connectivity software, 
and, optionally, word processing, spread- 
sheet, and business graphics applications in- 
stalled in an office. 

Within the client/server paradigm, the 
industry-standard PC is a generally accepted 
platform for the office client. As the office 
client will be used by most, if not all, office 
workers, professionals, and managers in a 
business, understanding its requirements is 
very important. Basic requirements for an of- 
fice client are illustrated in Figure 1. Let’s ex- 
amine each element in the figure: 

1. Industry-standard PC system. The sys- 
tem must contain adequate memory and 
disk storage to support the selected oper- 
ating system and applications. An Intel 
80486 processor operating at 33 MHz or 
higher, 8 to 16 megabytes (MB) of memory 
and a 200-MB hard disk should be consid- 
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ered a typical configuration for a full-func- 
tion office client. 

2. A color graphics monitor capable of 
supporting from 640 by 480 (VGA) to 
1,024 by 768 (XGA, SVGA) graphics reso- 
lution. This is a widely supported indus- 
try standard, adequate for most user ap- 
plications. Fifteen-inch diagonal screen 
size and noninterlaced image support are 
optional requirements. 

3. A robust, multitasking operating sys- 
tem, able to support a broad range of of- 
fice and nonoffice applications with good 
performance. 

4. A Graphic User Interface (GUI), that 
has consistent human factors and a good 
performance. 

5. Network connectivity able to provide 
adequate bandwidth for all office applica- 
tions. This should be a 16-Mbps token- 
ring or 10-Mbps Ethernet LAN adapter for 
starters. 

6. Peripherals support may be a require- 
ment for a subset of users. Typical periph- 
erals requiring support include CD-ROM 
(internal) or a personal laser printer. Some 
users requiring multimedia support may 
require a sound card with stereo speakers 
or a video card to display video clips. 


USER INTERFACE 

A user interface is a general term for the 
way the user interacts with a computer sys- 
tem to get it to perform useful work. 
Consistency and user-friendliness were the 
key user interface requirements during the 
migration period. A common GUI was the 
obvious choice as provided by OS/2 
Presentation Manager. It offered a flexible 
windows application environment with 
consistent controls and rich customization 
capabilities. 
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OPERATING SYSTEM 

It is important to select a single operating 
system for the office client that meets your 
requirements. If it is designed well, it will 
support multiple applications efficiently, al- 
lowing them to share the client system hard- 
ware resources (such as processor, memory, 
and input/output devices) without error or 
conflict. It should support the broadest set of 
industry-standard applications to give you 
the broadest latitude in application selection. 
It is also a complicated piece of software that 
requires occasional service—bug fixes, up- 
grades for new features or releases, or cus- 
tomization for new applications or system 
hardware. When a single operating system is 
selected, fewer support staff are required to 
assist users. Standardized maintenance pro- 
cedures can be created, thereby minimizing 
cost. 

From all angles, OS/2 was the best 
choice as Boca’s standard client operating 
system. It is a robust, 32-bit, true multitask- 
ing software system that supports most of 
the PC-based applications available, includ- 
ing DOS, Windows, and OS/2 applications. 
Over two-thirds of the users were OS/2 lit- 
erate and had early versions installed al- 
ready. Not the least significant in the selec- 
tion was that IBM Boca Raton is the home of 
OS/2 development. This led to key advan- 
tages in support, quality, and (most impor- 
tant) acceptance. 

OS/2 provides an industrial-strength 
base for client/server migration. It is a fully 
architected operating system with an ad- 
vanced object-oriented user interface avail- 
able. In addition, OS/2 has crash and appli- 
cation protection. 


HARDWARE 

Selecting industry-standard hardware sim- 
plifies upgrades and maintenance. The 
broadest array of hardware upgrade and pe- 
ripheral products are available. Since Boca 
Raton was the home of the IBM PC Co., al- 
most all of the PCs were to be either IBM 
PS/2 or PS/ValuePoint systems. 

One mistake that was made was allow- 
ing individual departments too much leeway 
in ordering specific PC systems. The diver- 
sity of systems, even within a single depart- 
ment, added difficulty to the PC manufactur- 
ing process. 

The Intel 80486DX, operating at 33 MHz 
(million cycles per second) and with 16 MB 


NOVEMBER/DECEMBER 





of RAM (random access memory), was se- 
lected as the minimally capable processor 
complex based on informal benchmark test- 
ing performed in 1993. The bottom line was 
that application performance was too slow 
without this processor-memory combination. 
The minimum disk storage capacity of 240 
MB was selected based on two factors. First, 
the standard applications plus utilities took 
up approximately 160 MB of disk storage, so 
a reasonable additional amount needed to be 
available for data and other applications. 
Second, several models in PC Co. inventory 
offered a 240-MB hard file. 

Hard disks were logically partitioned in 
a standard manner (a physical disk is said to 
be logically partitioned when the operating 
system treats it as more than one disk, each 
with its own drive letter). The disk partition- 
ing was based upon practical experience with 
PC-operating systems. A 100-MB space was 
allocated to the C drive to contain operating- 
system-related code. This included OS/2, 
IBM Communications Manager/2, LAN 
Requester, DOS Dual Boot, and LAN Station 
Manager. Isolating the operating system and 
its utilities into its own logical drive enabled 
update or replacement of this code with min- 
imal impact to any user applications. 

A VGA CRT display, with 640 by 480 
resolution and up to 256 simultaneous col- 
ors, was deemed adequate graphics display 
resolution for the office client, although 
many systems were equipped with either 
XGA or SVGA resolution. 

The standard applications used the 
NetBIOS protocol for local LAN communica- 
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Figure 1. Typical office client. 
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Figure 2. [BM Boca Raton office client rollout process flow. 


tion. Some of the utilities used TCP/IP 
for both LAN and WAN communica- 
tion. SNA, IBM’s standard mainframe 
network architecture, was used for ter- 
minal emulation communication from 
PC to mainframe. The site network 
supported these multiple protocols 
transparently, as all the LAN internet- 
works were connected using bridges, 
which do not see the differences in the 
higher-level protocols. 

The standard hardware interface 
to the site network was a token-ring 
adapter card, operating at 16 Mbps. 
All existing site PCs and workstations 
were already equipped with these 
adapter cards, and the site network 
was already operating at the 16-Mbps 
speed. 

The most common peripheral in 
user offices was a personal printer, ei- 
ther a dot matrix or a laser printer. 
Host-attached laser printers supple- 
mented this capability. A migration to 
LAN-attached printing is underway at 
the present time. 

Some less common peripherals 
were CD-ROM drives and multimedia 
adapter cards (sound, video), which 
were increasing in number during the 
transition period. 


OFFICE CLIENTS ROLLING 
OFF THE ASSEMBLY LINE 
Once you have selected your standard 
office client’s software and hardware, 
you face the daunting task of upgrad- 
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ing each user with the minimum sys- 
tem so that all can participate in the 
new environment. It requires a well- 
run team of trained specialists working 
closely with users and other support 
teams. For a large rollout, assembly 
line processes are called for to achieve 
success, 

In January 1994 in Boca, over 
2,700 office client PCs were to be either 
upgraded or replaced by the end of the 
third quarter of 1994 by the Client 
Rollout Team, Approximately, 700 sys- 
tems were completed in 1993, so just 
over 2,000 remained in 1994. This 
meant that the target of installations in 
1994 had to average 50 systems per 
week (or roughly 10 per working day) 
for the rollout to be successful. Based 
upon the inventory of installed PCs, 
the Client Rollout Team made the as- 
sumption that 70% of the systems were 
to be replacements (brand new sys- 
tems) and 30% were to be upgrades. 

The team started with the follow- 
ing general objectives, which are ap- 
plicable to any client rollout: 

1. Minimum disruption to user’s 
current work. 

2. All standard software prein- 
stalled. 

3. Final software customization 
would occur in the user’s office by 
trained installer. 

4. Installation would take no more 
than four hours. 

5. All user data from current system 
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would be migrated 
by the installer at 
time of installation. 

6. Up to three appli- 
cations from the 
former system 
would be migrated 
to the new system. 

7. Users must return 
old PCs that had 
been replaced. The 
returned systems 
were to be reused 
or scrapped. 

Your approach to 
client installation or 
upgrade should be 
comprehensive. It 
should be based on 
the Golden Rule (Do 
unto others as you 
would have others do 
unto you), because 
each office client up- 
grade has a signifi- 
cant psychological, 
intellectual, and phy- 
sical impact on a new 
user, This was the approach used in 
Boca. 

The Boca process was comprehen- 
sive and included the following steps: 

1. Department focal points were 
identified to handle early informa- 
tion gathering and keep department 
members informed. 

2. Area meeting presentations were 
performed to set expectations and 
communicate the plan. 

3. Completion of a comprehensive 
user questionnaire, to establish user 
PC requirements, was required of 
every user. 

4, Hard disks of new PCs were per- 
sonalized with software through 
replication over the network from a 
“custom” master disk, which was 
for the department. 

5. Personalized PC replacements or 
upgrades were carefully scheduled. 
This included installation of the stan- 
dard desktop and maintenance of all 
prior capabilities (VM access, print, 
and up to three PC applications). 

To support this ambitious effort, 
the Client Rollout Team set up a pri- 
vate local area network. It was used to 
efficiently transfer disk images of the 
standard applications software suite to 
fully configured PC systems, 

The assignment of user focal 
points is highly recommended for 
your rollout. The focal point should be 
a person in each area or department to 
serve as your local agent to communi- 
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Figure 3. Manufacturing process—new builds. 


cate directly with each person to re- 
ceive a new or upgraded PC. The goal 
should be to have a focal point in each 
department (10 to 20 clients). At the 
IBM Boca Raton site, this proved to be 
unrealistic. A few organizations with 
100 to 200 clients had assigned only a 
single individual to serve them. In ad- 
dition, this was a part-time responsi- 
bility for the majority of the focal 
points. The focal point key duties 
should be: 
1, Ensure completion of client ques- 
tionnaires. The questionnaire should 
be taken online by most clients. It 
gathers comprehensive information 
of client requirements. Appendix D 
includes a sample copy. 
2. Order network identifiers and key 
software licenses. At IBM Boca 
Raton, the Client Rollout Team or- 
dered TCP/IP identifiers and Lotus 
Notes licenses for clients. 
3. Track new PC orders and gather 
data on PCs to be upgraded, 
4. Communicate with the Client 
Rollout Team and the clients 
throughout the rollout period. A 
weekly meeting run by the team 
should review all progress and 
problems. This proved to be a vital 
activity in IBM Boca Raton. 

A well-defined group-by-group 
rollout process should be initiated 
once a focal point is identified. In Boca, 
the Client Rollout Team defined an 
eight-week rollout process for each 
group. It was viewed as a week-by- 
week countdown, where week eight 
was the kickoff leading to week one’s 
eventual in-office installation (Figure 





2). Week eight began with a presenta- 
tion to the users (Customer Commu- 
nication #1). This was an overview of 
the Client/Server Migration with spe- 
cific emphasis on the client rollout. 
Other activities initiated during week 
eight were creation of TCP/IP ad- 
dresses, ordering Lotus Notes licenses 
for each user, tracking of hardware de- 
liveries, and validating their accuracy 
vs. requirements. 

During week seven, emphasis was 
placed on completing user question- 
naires. As these were accu- 
mulated, user require- 
ments were solidified, in 
particular the breakdown 
of replacement PCs vs. PCs 
to be upgraded. This as- 
sessment was important in 
that it impacted installation 
resources. Through experi- 
ence, the Client Rollout 
Team learned that com- 
plete PC replacements took 
from two to four hours in 
the user’s office, whereas 
upgrades took from five to 
twelve hours. The accumu- 
lated user requirements 
were prioritized along with 
available inventory, as 
well. This resulted in trans- 
ference of inventory meet- 
ing those requirements to a 
holding area awaiting final 
customization. 

By week six, the user 
group’s requirements were 
sufficiently solid to enable 
initiation of a pilot master 
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Figure 4. Office clients ready to go. 


build—the creation of a master hard 
disk to undergo testing during weeks 
five through two. 

In week five, the Server Admini- 
stration team created Lotus Notes and 
NetDoor identifiers for each user. 
These identifiers allowed users to ac- 
cess the applications. 

In week three, each customer was 
contacted individually to set up a re- 
placement or upgrade appointment. 
After the appointment was made, care- 
ful follow-up with the user was the 
rule to minimize no-shows. 

At week two, the master hard disk 
configurations for an area were final- 
ized. They included the standard ap- 
plications plus any unique area re- 
quirements. Unique area requirements 
were specific applications that an area 
needed to do its job. For example, all 
OS/2 developers required an applica- 
tion which linked them to their soft- 
ware code library and problem-track- 
ing database. 
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Figure 5, Manufacturing process—upgrades (original process). 
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During week one, the PC manu- 
| facturing process began. Figure 3 de- 
tails the manufacturing process for 
new builds and identifies the staffing 
employed. Figure 4 shows a set of 
client systems ready to be delivered. 
The last step completed the manufac- 
turing process with the in-office instal- 
lation. Typical in-office installation 
time for new systems was two to four 
hours. 

Figure 5 details the original manu- 
facturing process for upgrades, which 
was completed entirely in the user’s 
office. However, due to the variability 
of results with this method (from five 
to twelve hours), it was enhanced in 
June 1994 to combine in-office and 
manufacturing line sections (Figure 6). 

Deliveries of new PCs or up- 
grades to existing ones received the 
personalized attention of a trained 
and skilled installer. The installers 
were contractors, specially trained to 
perform the installation or upgrade 
function. Every effort was made to 
provide same-day functionality for all 
user PC requirements. A complete in- 
formation package was provided with 
the installation to answer most, if not 
all questions. 

Up to three personal applications 
were migrated to new PCs by the in- 
staller, provided proof of license was 
presented and original diskettes were 
available. All old PC data were mi- 
grated to new PCs during the installa- 
tion as well. This was accomplished by 
copying the entire existing hard disk 
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files to a backup server on the network 
at the beginning of the installation/up- 
grade process, After installation/up- 
grade, the reverse copy was performed 
to an OLDDATA directory on the new 
or upgraded PC. If a PC was replaced, 
the old system remained in the user’s 
office for about two weeks, just in case 
it was needed if the new PC failed. At 
the end of two weeks, the PC Returns 
department, a site services group, re- 
claimed the old system for either sale 
to another IBM site or refurbishment 
and redeployment. 

The Lotus Notes application 
played a critical behind-the-scenes roll 
for the Client Manufacturing process. 
Eleven Notes databases were em- 
ployed, serving as information reposi- 
tories, workflow automation, and 
tracking applications. The Client 
Implementation Library Notes data- 
base contained procedure, process, 
and forms documents specific to the 
client rollout. The [SSC Document 
Library, another Notes database, con- 
tained general application installation 
procedure documents. The User 
Questionnaires were imported and 
maintained in a consolidated Notes 
database. (Imported means that the 
data required conversion to the Notes 
format. This was required because 
most users employed VM to complete 
the questionnaire.) The Master 
Configuration database contained de- 
scriptions of the hard file masters to be 
used by the Client Manufacturing 
process. Three Notes databases were 
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Figure 6. Manufacturing process—upgrades (revised process). 
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used for client tracking and scheduling 
by the Installation Team. Three Notes 
databases were set up to inform users 
of their migration schedule, provide a 
migration checklist, and, most impor- 
tantly, track purchase orders for new 
equipment. 

The Boca eight-week client rollout 
process was highly successful. It can 
easily be generalized to apply to your 
client rollout. 


THE CHALLENGES OF A CLIENT ROLLOUT 
(KEEPING MURPHY AT BAY) 
A client rollout is extremely challeng- 
ing and requires a highly synchro- 
nized “manufacturing” process, wor- 
thy of a case study in industrial 
engineering! Many things can go 
wrong, and will (according to Mur- 
phy’s Law), unless careful planning is 
performed. Several elements require 
synchronization, including: 
¢ Gathering and logging customer 
data profiles and requirements. The 
comprehensive user questionnaires, 
when consolidated in a readily 
available database (for example, 
Lotus Notes), meet this requirement. 
¢ Inventory delivery, staging, and 
control, Hardware delivery sched- 
ules can be unpredictable. They can 
be minimized through flexibility in 
schedule management, establish- 
ment of a three- to four-week inven- 
tory of readily accessible hardware, 
and supported by a (Lotus Notes) 
tracking database. 
¢ Work-in-process management. 
Well-laid-out processes (see Figures 
4 through 8) make the difference. 
Technical requirements changes. 
This is inevitable, as software levels 
change or last minute user requests 
filter in. The rollout team must be 
flexible and responsive to properly 
handle these changes. 
Workload balancing. The client in- 
stallation team must be well- 
trained and proficient in their tasks 
to accommodate workload balanc- 
ing. Installers should be PC-famil- 
iar at least, with application and 
some operating-system modifica- 
tion experience. 
» Network-based software installation 
delivery. This is critical technology 
for large-scale client migration. 
Setting customer expectations. 
Customer expectation of each phase 
of the process should be appropri- 
ately set. A mass client migration 
takes a good deal of the “personal” 
out of a user’s personal computer. 
This is increasingly inevitable as 


client/server technology matures. 

¢ Scheduling with the user. This is a 
delicate matter. Problems can be 
minimized through use of the air- 
lines’ method of overbooking (a key 
insight) and up-to-the-minute 
scheduling communication with the 
user. 
Additional user visits. Installation 
problems requiring additional user 
visits by installers add schedule 
pressure. This can be minimized 
through the use of carefully docu- 
mented procedures and up-front 
testing by the installation team. The 
use of (Lotus Notes) tracking data- 
bases for sharing of information can 
help here. 

By the end of the third quarter of 
1994, the Boca Client Rollout Team 
rolled out over 2,000 new or upgraded 
PCs. They met the goal of over 2,700 
enabled PCs delivered to the users. 


CRITICAL SUCCESS FACTORS 

The office client rollout is the heart of 

any client/server migration. Following 

are some key recommendations that 
will lead you to success in this critical 
phase: 

* You should carefully identify the 
minimum hardware requirements 
for client PCs. This should be based 
upon performance evaluations of se- 
lected applications on a real system. 
Ensure that processor, memory, and 
disk storage can be upgraded if re- 
quired. Secondarily, allow installa- 
tion of peripherals as upgrades. 

* There is no substitute for a complete 
inventory database of all user 
clients. This is required initially to 
scope the investment necessary to 
migrate to a client/server environ- 
ment. It is required on an ongoing 
basis in order to track asset owner- 
ship and identify upgrade candi- 
dates. Investing in automatic client 
inventory maintenance is very 
worthwhile. 





¢ You should create a completely de- 
fined process for a large-scale client 
PC rollout. This should include 
user communication (gaining buy- 
in, setting expectations), installa- 
tion logistics, and tools. Flexibility 
in scheduling is also critical. 
Through careful schedule manage- 
ment and overbooking client PC in- 
stallations, your rollout team can 
achieve success. 

* Invest in groupware, groupware, 
groupware. The use of Lotus Notes 
databases enabled the incremental 





by IBM 


VX*REXX for OS/2 
by Watcom 


Powerful and easy-to-use integrated 


PM applications, including a project 
management facility, visual designer 


menus, DDE, objects and more. 
$95.00 (MSR $99.00) 
Order number 211] 





GET THE LOWEST 
OS/2 PRICES- 


VisualAge C++ for OS/2 version 3.0 


Version 3 of VisualAge C++ offers you visual programming 
tools that make building applications simpler. 


3.5” disk with documentation $429.00 (MSR $525.00) Order number 448 
CD ROM | $370.00 (MSR $449.00) Order number 449 
CD ROM with documentation $409.00 (MSR $489.00) Order number 450 


call for prices on upgrades from v2/v2. | 


environment for developing OS/2 2.x 


and debugger. New to this version are 
Notebooks, Containers, Sliders, Popup 


These products and many more 

PLUS our lowest price guarantee. 

OS/2 Express promises to match or beat nationally advertised prices for 
O$/2 software we carry. Just place your next order with OS/2 Express. 
If you find a vendor that can fill your order for less elsewhere (including 
shipping, handling, credit card fees and other surcharges), send or fax us 

the ad within seven days. We'll match it. 


EXPRESS 
1-800-0S2-KWIK 


For orders call 1-800-O52-KWIK (1-800-672-5945) * Fax (612) 823-6267 © International (612) 823-6255 | 


improvements made by the Boca 
client rollout team in their process. 


Steve Krantz /s a senior programmer with IBM 
in Boca Raton, Fl. He is the project leader 
responsible for the Boca Raton client/server 
migration in 1994, During his 27 years with 
IBM, Krantz has held several management and 
technical positions. He has a Ph.D. in Computer 
Science from Nova Southeastern University, an 
M.S. in Systems and Information Science from 
Syracuse University, and a B.A. in Mathematics 
from Queens College. 









eS — 


SPF/PC v 4.0 

by Command Technology 

SPF/PC is a powerful file manager 
and full-screen text editor that emu- 
lates IBM’s mainframe ISPF/PDF, pro- 
viding a familiar environment for 
mainframe programmers faced with 
the challenge of developing on a PC. 
$189.00 (MSR $295.00) 

Order number 186 





























Circle Reader Service Number 10 


NOVEMBER/SDECEMBER 


rags 








Writing a server from scratch using interprocess communications can be challenging. 
Here's an example that works. 
By MICHAEL J. BARILLIER 
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OS/2 Server Design 
Using Named Pipes 


utting-edge technology in cli- 

ent/server computing today would 

appear to be independent applica- 
tions accessing a remote database. Scan 
through any computer-related magazine 
and count the number of database advertise- 
ments that do not include the term 
“client/server” somewhere in the text (from 
personal experience, this number should be 
very small). 

Despite what the DBMS software devel- 
opers claim, a database is nothing more than 
a resource, like memory or disk space, not an 
application server. While an application-to- 
DB server topology may be easy to imple- 
ment, system data storage is left wide open 
to all clients, preventing any data hiding or 
encapsulation. All rules concerning the stor- 
age of the system’s data must be built into 
each client, resulting in development and 
maintenance headaches. (While a database 
may start out normalized, it generally falls 
victim to entropy over time.) A server 
should be more than just a data repository— 
it should provide services and statistics, 
exert intelligent control over clients con- 
nected to it, and interact with clients in con- 
cepts relevant to the system, not just raw 
rows and columns. If a billing system is 
being implemented, transactions should con- 
sist of customer and invoice objects, not 
VARCHARs and INTEGERs. 

Building a server isn’t a trivial task, 
however. Management-types, obsessed with 
project completion dates, aren’t very recep- 
tive when a developer announces that 
he/she is going to write a server from 
scratch. “What’s wrong with using a data- 
base server?” they ask. “After all, every air- 
line magazine article I’ve read on the subject 
says that’s the way to go.” Also, less-experi- 
enced programmers may be intimidated 


when faced with the challenge of inter- 
process communications. This article should 
help in two ways. First, it demonstrates basic 
server design and interprocess communica- 
tion, and second, the sample code in Listings 
1 through 4 can be gutted and used as a 
skeleton for many client/server environ- 
ments. 


SYSTEM OVERVIEW 

The example server, Tserver, supports multi- 
ple simultaneous connections through 
named pipes. (The source code for Tserver is 
available on CompuServe in OS2DF2 as 
TSRVR.ZIP.) Many interprocess communica- 
tions methods are available under OS/2 such 
as shared memory, named pipes, APPC and 
APPN, TCP/IP, IPX/SPX, NetBIOS and RS- 
232, to name a few. The only methods avail- 
able on an out-of-the-box system, however, 
are shared memory, named pipes, and 
async. Of these, only named pipes is useful 
for interprocess communications between 
applications running either on the same 
workstation or on separate workstations. 
Client interaction with the server can be im- 
plemented using a simple fopen/fputs/ 
fgets/fclose sequence. Also, named pipes can 
be accessed by DOS and Windows applica- 
tions, given the proper software support, 
which means that the server can take advan- 
tage of OS/2’s multitasking, crash protec- 
tion, and system resources while serving 
clients running on lesser operating systems 
(yes, lam an OS/2 bigot). 

Interaction between Tserver and clients 
is \n-terminated ASCII text messages, rather 
than the binary packets traditionally used in 
client/server communication. For example, 
if Tserver is sent the command string, 


TIME 
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the client would receive something like 
OK 13:21:05 


I’ve found that text-based communica- 
tions makes the server incredibly easy to ac- 
cess and test. One system that I built needed 
to have multiple clients simultaneously 
making different requests to stress test the 
system. Rather than write C applications, I 
wrote the clients in a few minutes in REXX, 
using lineout and linein to access the server. 
(More on client design later.) 


SERVER DESIGN 

Tserver is written as a multithreaded, VIO- 
based application. Interthread communica- 
tion is through homemade message queues. 
These queues are simple singly linked lists 
with a mutex semaphore and an event sema- 
phore to provide access serialization and 
message availability notification. 

main(). The primary application thread 
is responsible for installing a break handler, 
starting the subthreads, dispatching mes- 
sages between the threads, and updating the 
application’s output, which consists of the 
current time and, whenever an interesting 
event occurs within the server, a descriptive 
text message. The message processing loop 
ends when a breakhit message (as posted by 
the break handler) is pulled from the main 
message queue. 

Connect thread. The first thread started 
by the primary thread is the connect thread, 
which waits for clients to connect to an in- 
stance of Tserver’s named pipe and posts 
the handle of the newly connected pipe to 
the main message queue. The function that 
implements this thread, connectthread(), is 
pseudocoded in Listing 1. connectthread() is 
loosely designed as a finite-state machine, 
with lots of labels and gotos. (While some 
programmers avoid gotos at all costs, com- 
munications applications in general are sig- 
nificantly simplified with their use.) 

In general, connectthread() creates a 
named pipe, then waits on its shutdown 
semaphore for a short time. If not posted, 
connectthread() checks the pipe for a connec- 
tion (the pipe is created in nonblocking 
mode). If a client has connected, the handle 
is passed to main() through main()’s message 
queue, a new instance of the pipe is created, 
and the loop starts over. . 

Although DosCreateNPipe() includes an 








Listing 1. connectthread() pseudocode. 
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instance count that may be unlimited, 
| the number of file handles available to 
an OS/2 process is limited by the 
FILES= statement in config.sys (the de- 
fault value is 20). To avoid this limita- 
tion, the FILES= statement can be 
changed, but this would be system- 
wide and a waste of resources. An al- 
ternative is to check for an ERR- 
OR_TOO_MANY_OPEN_FILES return code from 
DosCreateNPipe(), and when found, to 
call DosSetRelMaxFH(), incrementing the 
number of handles available. To keep 
the handle maximum from growing 
without limit, Tserver sets the pipe in- 
stance count in DosCreateNPipe() to a 
reasonable value. Once the maximum 
pipe instances have been created, 
DosCreateNPipe() will return ERR- 
OR_PIPE_BUSY, and connectthread() will 
go back to waiting on the shutdown 
semaphore. 

Because the number of handles is 
limited, the number of simultaneously 
connected clients is also limited. 
Tserver’s design is transaction-based, 
so clients will not normally be con- 
nected for an extended amount of 
time. If the clients must keep their 
connections open for multiple transac- 
tions, and if a large number of clients 
exists, then the server design becomes 
more complicated. 

Client handler thread. The third 
thread in Tserver is the client handler 
thread. As clients connect to Tserver’s 
named pipe, connectthread() passes the 
handles to main(), which in turn 
passes them on to clienthandlerthread() 
through a message queue. clienthan- 
dlerthread(), pseudocoded in Listing 2, 
maintains a linked list of clientinfo 
structures, each of which contains the 
handle of the pipe to the client and a 
buffer containing text received from 
the client but not yet terminated by a 
newline. 

New handles arriving in con- 
nected messages are packed into cli- 
entinfo structures and placed in the 
linked list. If a shutdownreq message is 
not received, then clienthandlerthread() 
works through the list and appends 
any data waiting in the client’s pipe to 
the command buffer for that client. 
The command buffer is parsed and 
any commands executed. A \n-termi- 
nated result string will always be re- 
turned to the client following com- 
mand execution, and the format of 
that string is dependent upon the 
command executed. The first token in 
the string will be "0K" or an error indi- 
cator such as “EBADCMD" or "EOFLOW". If 
the token is "0K", it will be followed by 
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Listing 2. cLienthandlerthread() pseudocode. (Continued on page 33.) 


any data resulting from the execution 
of the command, such as the current 
time for the time command. 


CLIENT IMPLEMENTATION ISSUES 

At the client end, a named pipe acts 
just like a file, and a named pipe han- 
dle can be used in DosWrite() and 
DosRead() calls just like any disk-based 
file handle. As mentioned before, a 
client can also access a named pipe 
using the C library file I/O function 
calls (for example, fopen, fputs, fgets). 
Listing 3 shows a series of calls to con- 
nect to Tserver and to request the cur- 
rent time using standard C file I/O 
(error handling has been omitted for 
simplicity). This example opens a lo- 
cally named pipe, \pipe\time, but to 
access a remote named pipe the only 
change required is to place the server 
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workstation name in front of the pipe 
name, for example, \\appsrvr\pipe\time. 
Note the use of fflush() between the 
fputs() and fgets() calls. The C Set++ 
documentation states that a file handle 
can be used for both reading and writ- 
ing, but a call to a file-positioning 
function, such as fseek() or fflush(), 
must be made between read and write 
operations. 

Access to a server using named 
pipes can be dropped into many dif- 
ferent types of clients. Both OS/2 VIO 
(windowed and full-screen text 
processes) and Presentation Manager 
applications can access this type of 
server, although a PM application de- 
sign should take into consideration in- 
terface responsiveness. Because server 
response time is generally unknown, 
the I/O sequence should not be placed 





Listing 2. clienthandlerthread() pseudocode. (Continued from page 32.) 


in the PM message processing thread 
to prevent the client program from 
locking up during these transactions. 
DOS and Windows applications can 
also access an OS/2 server using 
named pipes—I have developed DOS 
applications that run on workstations 
connected using Novell LAN software 
with named pipe support, which ac- 
cess OS/2-based servers. I must 
admit, however, that I have not actu- 
ally written a Windows application 
that uses named pipes, but because 
Windows runs on top of DOS 
(Windows isn’t a true operating sys- 
tem, remember?), I have to believe 
that this design is possible. 

Listing 4 shows an excerpt from 
gettime.cmd, which uses REXX to ac- 
cess the server. I generally use REXX 
clients when I want to knock out the 


Listing 3. Accessing Tserver from C. 


client as quickly as possible, or | am 
building a client that performs some 
sort of background processing. 


ENHANCEMENTS 

Tserver is a very simple application, 
performing very few functions. What I 
consider the tougher part of the 
design—connection monitoring and 





NOVEMBER/DECEMBER 


oe 


client communications—can be used 
as is, so the largest part of the en- 
hancement process will probably con- 
sist of modifying Tserver’s command 
parser. The parser used within Tserver 
does nothing but use stricmp() to 
check the first word of the command 
buffer for either "time" or "shutdown". A 
better solution would be to use an 
LALR parser, such as the code gener- 
ated by Lex and YACC. Not only is 
the processing more efficient for large 
command sets or complex grammars, 
but the code will be far easier to main- 
tain and expand. 

Commands received by client- 
handlerthread() are processed sequen- 
tially. Because of this, a command 
from a client, which takes a long time 
to process, will cause clients further 
down the list to wait. One solution to 
this problem is to use a worker thread 
pool. Once a \n-terminated command 
is detected, clienthandlerthread() 
would pull the clientinfo structure 
from the list, post it to the worker 
pool for processing, and then con- 
tinue handling input from other 
clients. If there are waiting worker 
threads in the pool, the message 
would be posted to the waiting thread 
for immediate processing. If there are 
no waiting threads and the maximum 
number of threads has not been 
reached, then a new worker thread 
would be created. If the maximum 
number of threads had been created 
and all were busy, the command 
would be queued. The worker threads 
would check the queue when their as- 
signed processing was completed. If 
no command was pending, they 
would go to a waiting state for an in- 
ternally specified time and exit if no 
message was posted during that time. 
This avoids having threads wait for 
work when nothing has been avail- 
able for a while. Once the worker 
thread completes its processing, the 
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| Take control of your OS/2 Aiiankadt Teak Selmi tebe needs with | 
Version 3.0 - 

Are you looking for @ way to Here are some of the features of 

manage your production job ATS for OS/2: 

streams? Doyouhave programs * Manage Production Job 

that need to run after the Streams 

completion of one or more other = * Programs can be scheduled to 

programs? Doyouwanttorun = pun anytime. 

programs one reguiar basis? D0 * Programs can be dependent 

you want toprocessfilesthat = upon Files, Other Programs, 

have just been received from Holiday Schedules, and 

another system or modified External Signals 

| locally? Do you need to take action * integrated Operators Console 

| ‘fafile is missing? Do youneedto * Logging-To File and Console 

Schedule around holidays and New Features: 

| periods of heavy CPU load? * Job Queues - for managing 

With ATS you can run your your resources while managing 

programs when YOU wantthem your tasks 

torun with out youhavingtobe  * Periodic Scheduling 




























I there. averl® * COMPLETE API and Command 
aes PY ec% ones Line Interface 
jeeSeeecti mui (On 
a n ti 
fore” iol aS saaas Highway #1 *Sulte 146 $349 






North Brunswick, NJ 08902 
821-0350 * Comp 






uServe 70312,627 





Turn your excess inventory 
into a tax break 
and help send needy 
kids to college. 


” Mas Call for your 
es b free guide 
V ey $ to learn how 
<7 donating your 
| slow moving inventory 
can mean a generous 
TAX WRITE OFF 
for your company. 


Call (708) 690-0010 


P. O. Box 3021 
Glen Ellyn,IL 60138 
Fax (708) 690-0565 





Need some help 
with that? 


Excess inventory today....student opportunity tomorrow 





OS/2 DEVELOPER 


clientinfo structure would be re- 
turned to clienthandlerthread() and re- 
inserted into the linked list. 

And finally—a database. Nowhere 
in the server design presented in this 
article has a database been required, 
nor have the clients needed to access 
data using SQL. If the server will be 
maintaining a large amount of data, 
then a database should be used inter- 
nally to facilitate its storage and access. 
However, the clients do not need di- 
rect access to the database, nor should 
they care whether the data is stored by 
the server in a true database, in flat 
files, or on stone tablets etched in 
Sanskrit. If, for some reason, the end 
users insist on using Query Manager, 
Paradox, or some similar product to 
build their own ad-hoc queries, then 
consider building a client support ap- 
plication to mirror system data to a 
separate user-accessible database. The 
clients can then build any query they 
like but will be unable to access the 
server's copy of the data and possibly 
crash the system. 


SUMMARY 

I had originally intended this article to 
be a soapbox tirade against the 

“client/server requires a database” 

philosophy, but decided instead that a 
viable alternative would be a better ar- 
gument than uncontrolled ranting. 
The design, used by Tserver, is not 
technically advanced but is useable in 
many applications where traditionally 
a remote database server would be 
used. If nothing else, I hope this article 
will get at least a couple of developers 
(and managers) to break out of the old 
mindset and use their own creativity 
and programming skills. 


Michael J. Barillier is the head of Rene- 
gade Digital Technologies, a software devel- 
opment and consulting company in St. Louis, 
Mo. He has been working with OS/2 since 
1989 and has extensive experience with 
client/server and object-oriented design. 
Barillier can be reached via Internet at 
mjb@inlink.cam. 





An excerpt from Bob, Dan, and Jeri’s latest book on client/server with distributed 
objects and components—including OpenDoc, CORBA, and OLE. 
By ROBERT ORFALI, DAN HARKEY, AND JERI EDWARDS Rabon 


When CORBA 
Objects Meet 
Transactions 


- ransactions are essential for build- 
ing reliable distributed applications. 
So it should come as no surprise 
that transactions and distributed objects are 
getting married. The Object Management 
Group’s (OMG) newly adopted Object 
Transaction Service (OTS) defines IDL inter- 
faces that let multiple distributed objects on 
multiple CORBA ORBs participate in atomic 
transactions—even in the presence of cata- 
strophic failure. OTS optionally supports 
nested transactions. The support of nesting 
and inter-ORB transactions provides an ob- 
ject foundation for dealing with the complex 
world of multistep consumer-to-business 
and business-to-business transactions. 


THE CORBA OBJECT TRANSACTION SERVICE 

The Object Transaction Service (OTS) is pos- 
sibly the most important piece of middle- 
ware for distributed objects. OTS does a su- 











Figure 1. The flat transaction: an all-or-nothing 
proposition. 
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perb job of marrying transactions with ob- 
jects at the ORB level. With OTS, ORBs pro- 
vide a seamless environment for running 
mission-critical components. This feature 
alone gives ORBs a leg up over any compet- 
ing form of client/server middleware. An 
ORB becomes the next-generation TP 
Monitor. In this article, we first go over what 
makes transactions so important. Then we 
introduce OTS. 


WHAT IS A TRANSACTION? 

Transactions are more than just business 
events: They’ve become an application de- 
sign philosophy that guarantees robustness 
in distributed systems. In an ORB environ- 
ment, a transaction must be managed from 
its point of origin on the client, across one or 
more servers, and then back to the originat- 
ing client. When a transaction ends, all par- 
ties involved agree as to whether it suc- 
ceeded or failed. The transaction is the 
contract that binds the client to one or more 
servers. A transaction becomes the funda- 
mental unit of recovery, consistency, and 
concurrency in a distributed object system. 
Of course, all participating objects must ad- 
here to the transactional discipline; other- 
wise, a single faulty object can corrupt an 
entire system. In an ideal world, all distrib- 
uted object interactions will be based on 
transactions. 

Transaction models define when a trans- 
action starts, when it ends, and what the ap- 
propriate units of recovery are in case of fail- 
ure. The flat transaction model is the 
workhorse of the current generation of TP 
Monitors (and other transactional systems). It 
is called flat because all the work done within 
a transaction’s boundaries is at the same 
level. The transaction starts with begin_trans- 
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action and ends with either a 
- commit_transaction or abort_transaction 


22 =» (Figure 1). It’s an all or nothing propo- 


sition—there’s no way to commit or 
abort parts of a flat transaction. 
However, the newer transaction mod- 
els—for example, nested transactions— 
provide a much finer granularity of 
control over the different threads that 


constitute a transaction. The newer 
transaction models are attractive be- 
cause they have the potential to better 
mirror their real world counterparts. 


OBJECT TRANSACTION 
SERVICE: FEATURES 
CORBA's OTS provides the following 


features: 


_ What's a Nested Transaction? 


Most of the alternatives to the flat transaction are based on mechanisms that 
extend the flow of control beyond the linear unit of work. Two of the most obvious 
ways to extend the flow of contro! are by chaining units of work in linear sequences 
__ of “mini” transactions (the chained transaction or Saga models) or by creating some 
kind of nested hierarchy of work (the nested transaction). 


— a = 


Nested transactions provide the ability to define transactions within other trans- 
actions. They do this by breaking a transaction into hierarchies of “subtransactions,” 


very much like a program is made up of procedures. The main transaction starts the 
_ subtransactions, which behave as dependent transactions. A subtransaction can also 


start its own subtransactions, making the entire structure very recursive. A subtrans- 
action’s effects become permanent after it issues a local commit and all its ances- 


_ tors commit. If a parent transaction aborts, all its descendent transactions abort— 

_ regardless of whether they issued local commits. 

Figure 2 shows a main transaction that starts nested transactions, which behave 
__as dependent transactions. Each subtransaction can issue a commit or rollback for 


= = 


allowing the main transaction to succeed. 


subtransactions. 





2. Nested transactions: one top-level transaction and many dependent 


its designated pieces of work. When a subtransaction commits, its results are only 
accessible to the parent that spawned it. The main benefit of nesting is that a failure 
in a subtransaction can be trapped and retried using an alternative method, still 


SUOOBSUEIGNG 
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Supports flat and nested transactions. 
All OTS implementations must sup- 
port flat transactions; nested trans- 
action support is optional. In 
nested environment, the flat transac- 
tion is the top-level transaction. 
Allows both ORB and non-ORB appli- 
cations to participate in the same trans- 
action. OTS lets you interoperate ob- 
ject transactions with procedural 
transactions that adhere to the 
X/Open DTP standard. 

* Supports transactions that span across 
heterogeneous ORBs. Objects on mul- 
tiple ORBs can participate in a sin- 
gle transaction. In addition, a single 
ORB can support multiple transac- 
tion services. 

¢ Supports existing IDL interfaces. A 
single interface supports both trans- 
actional and nontransactional imple- 
mentations. To make an object 
transactional, you use an ordinary 
interface that inherits from an ab- 
stract OTS class. This approach 
avoids a combination explosion of 
IDL variants that differ only in their 
transaction characteristics. 

OTS is a well-designed, low-over- 
head service that should perform at 
least as well as an X/Open-compliant 
procedural transaction service. 


THE ELEMENTS OF THE OBJECT 
TRANSACTION SERVICE 
Figure 3 shows the elements of OTS. 
Objects involved in a transaction can 
assume one of three roles: Trans- 
actional Clients, Transactional Servers, 
or Recoverable Servers. Let’s go over 
these roles and see what they each do. 
e A transactional client issues a set of 
method invocations that are brack- 
eted by begin/end transaction de- 
marcations. The calls within the 
bracket may be for both transac- 
tional and nontransactional objects. 
The ORB intercepts the begin call 
and directs it to the transaction ser- 
vice, Which establishes a transaction 
context associated with the client 
thread. The client then issues 
method invocations on remote ob- 
jects. The ORB implicitly tags the 
transaction context and propagates 
it in all subsequent communications 
among the participants in the trans- 
action. The ORB also gets involved 
when the client issues a commit or 
rollback and notifies the transaction 
service. The client is oblivious to all 
this under-the-cover activity; it sim- 
ply starts a transaction, issues its 
method invocations, and commits or 
rolls back the transaction. 


e A transactional server is a collection 
of one or more objects whose behav- 
ior is affected by the transaction but 
have no recoverable states or re- 
sources of their own. The ORB im- 
plicitly propagates the transaction’s 
context whenever these objects call a 
recoverable resource. A transac- 
tional server does not participate in 
the completion of the transaction, 
but it can force the transaction to be 
rolled back. 

* A recoverable server is a collection of 
one or more objects whose data (or 
state) is affected by committing or 
rolling back a transaction. Re- 
coverable objects are transactional 
objects with resources to protect. 
Examples of recoverable resources 
are transactional files, queues, or 
databases. Recoverable objects use 
the register method invocation to 
tell the transaction service that a re- 
coverable resource has just joined 
the transaction whose context was 
propagated in the client call. In ad- 
dition, recoverable objects provide 
methods that are used by a transac- 
tion coordinator (the coordinator is 
the transaction service) to orches- 
trate an ORB-mediated, two-phase 
commit protocol. 

OTS is seamlessly integrated with 
the ORB mechanisms. It relies on the 
ORB to automatically propagate the 
transaction context. Notice that the 
scope of a transaction is defined by a 
transaction context that is shared by 
the participant objects. The transaction 
context is a pseudo-object that’s main- 
tained by the ORB for each ORB-aware 
thread. The context is null when there 
is no transaction associated with a 
thread. The transaction service man- 
ages and propagates the transaction 
context with help from the ORB. 

OTS provides “IDL-ized” inter- 
faces for the objects that make up the 
transaction service. So it is possible for 
clients and transactional objects to get 
more intimately involved in the details 
of the transaction propagation via ex- 
plicit method invocations. However, 
most transactions will depend on the 
ORB to transparently do all the work 
using its built-in facilities. Fewer inter- 
ventions means better performance. 


THE OTS INTERFACES 

Figure 4 shows the four key interfaces 

of OTS; we left out the minor ones. 

Here is a brief description of what each 

of these interfaces do: 

¢ Current defines a CORBA pseudo- 
object, which makes it easy for 





clients to use OTS. Clients invoke 
begin and commit to start and end a 
transaction. The ORB will transpar- 
ently propagate the context of the 
pseudo-object to the transaction ser- 
vice and to all participants in the 
transaction. The context contains an 
ID that uniquely identifies the trans- 
action; it also contains status infor- 
mation. The client can invoke roll- 
back to abort the transaction. It can 
suspend the transaction to stop propa- 
gating the context with each mes- 
sage; it can resume it when it wants 
the context to be propagated. 
Get_control returns a Control object 
that you can use to directly interact 
with the transaction service—a re- 
coverable server typically invokes 
this method to obtain a reference to 
its transaction coordinator. A top- 
level transaction invokes set_timeout 
to define maximum elapsed time (in 
seconds) for its subtransactions to 
complete before it aborts them. 

* Coordinator is implemented by the 
transaction service. Recoverable ob- 
jects use it to coordinate their partic- 
ipation in a transaction with the 
OTS. A server invokes register_re- 
source to participate in a transaction. 
If it supports nested transactions, it 


Transactional 
Server 


Transactional 
— Client 


I \transactional 
a method 





instead invokes register_subtran_a- 
ware. It invokes create_subtransaction 
to create a nested transaction that’s 
a child of the current transaction. It 
invokes rollback_only to abort the en- 
tire transaction. The get_ and is_ op- 
erations are useful to servers that 
need to explicitly control their par- 
ticipation in a transaction. The hash_ 
operations return a handle to the 
current transaction. Before invoking 
register_resource, servers use the 
hashed value to find out if the cur- 
rent resource is already registered. 
Resource is implemented by a re- 
coverable server object to participate 
in a two-phase commit protocol. 
OTS uses the two-phase commit 
protocol to coordinate a transac- 
tion’s commit or abort across multi- 
ple server objects so that they either 
all fail or all succeed. To do this, 
OTS centralizes the decision to com- 
mit but gives each participant the 
right of veto. It’s like a Christian 
wedding: You're given one last 
chance to back out of the transaction 
when you're at the altar. If none of 
the parties object, the marriage takes 
place. 

In the first phase of a commit, 
OTS invokes prepare on all the partic- 
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Figure 3. Object transaction service: meet the players. 
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Figure 4. Object transaction service: the key interfaces. 


ipant resource objects. Each resource 
object returns in a parameter a 
“vote” value that is either vote_com- 
mit, vote_rollback, or vote_readonly. 
Based on the vote’s outcome (every- 
one has veto power), the transaction 
service either issues commit or 
rollback. It can also issue a forget to a 
resource object that’s fuzzy about its 
outcome. If the coordinator has only 
a single registered resource, it 
avoids the two-phase commit alto- 
gether and invokes commit_one_phase 
instead. 

* SubtransactionAwareResource is 
implemented by a recoverable server 
object with nested transaction behav- 
ior. This interface is derived from the 
Resource interface. It adds two new 
methods: commit_subtransaction and 
rollback_subtransaction. These meth- 
ods are invoked when subtransac- 
tions are complete. Subtransaction 
aware server objects must first regis- 
ter with the Coordinator object by in- 
voking register_subtran_aware. 

You should also be aware of the 
existence of a TransactionalObject in- 
terface. This is an abstract class that 
defines no operations. What is it good 
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for? It’s actually a very important 
class. It serves as a marker, which ob- 
jects use to indicate that they're trans- 
actional. To make your object transac- 
tional, you simply inherit from the 
TransactionalObject class. The ORB 
will then propagate the transaction 
context associated with a client's 
thread whenever the client invokes 
any method on your object. Note that 
the ORB passes this context in a special 
field (the context field) that is totally 
transparent as far you’re concerned. 


It's something ORBs do implicitly. 


AN OBJECT TRANSACTION SCENARIO 

Are you getting overwhelmed with all 
these interfaces? We will explain how 
these interfaces are really used with an 
annotated scenario (too bad we can’t 
animate an article). Figure 5 shows a 
scenario of a client doing a debit 
against one server object and a credit 
against another one. The example is 
“get $100,000 dollars out of Jeri’s ac- 
count in Bank A and put it in your ac- 
count in Bank B.” You don’t want this 
to fail, do you? The objects represent- 
ing Bank A and Bank B are recoverable 
server objects that multiply inherit 
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from the Resource class and the 
TransactionalObject abstract class (re- 
member, this is the indicator that does 
nothing). We also show two transac- 
tion service objects that are instances 
of the Current and Coordinator 
classes. The client initiates this transac- 
tion across the two servers and issues a 
commit when it’s done. Hopefully, the 
money will get tucked away safely in 
your account. Here’s the explanation 
that goes along with the numbers in 
the picture: 

1. Client begins transaction. The 
client invokes begin on the Current 
pseudo-object. The ORB passes this in- 
formation to the transaction service 
that maintains a Current object for 
each active transaction. 

2. Client makes a debit on Bank 
A’s object. The client invokes a debit 
method on an object in Bank A. This 
object implements the logic of the 
transaction (something you write), but 
it also inherits its behavior from the 
OTS classes Resource and Transac- 
tionalObject. So we're dealing with a 
recoverable resource object. 

3. Bank A’s recoverable object reg- 
isters its resource. The recoverable 
server object first invokes the method 
get_control on the Current object (the 
shorthand notation is Current: :get_con- 
trol) to obtain a reference to the 
Coordinator object. Then it invokes 
Coordinator: :register_resource to register 
with the coordinator object for this 
transaction. The coordinator keeps 
track of all the participants. 

4. Client makes a credit on Bank 
B’s object. The client invokes a credit 
method on an object in Bank B. This 
object implements the logic of the 
transaction (again, something you 
write) but also inherits its behavior 
from the OTS classes Resource and 
TransactionalObject. So we’re dealing 
with a recoverable resource object. 

5. Bank B's recoverable object reg- 
isters its resource. It’s a repeat of what 
Bank A’s server just did. 

6. Client issues a commit. The client 
invokes the method Current: : commit. The 
ORB informs the transaction service 
that the transaction has ended. 

7. Coordinator performs phase 1 
of two-phase commit. The coordinator 
invokes each participant’s prepare 
method to get a vote from all the par- 
ticipants on whether this transaction 
should be committed for posterity (that 
is, you get your $100,000). Let’s give 
this scenario a happy ending by assum- 
ing everyone returns a "vote_commit." 

8. Coordinator performs phase 2 
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Figure 5, Object transaction service: a two-phase Commit. scenario. 


of two-phase commit. The coordinator 
tells all the participants to commit. 
You now have $100,000 more to spend 
in your bank account. 

Are you all feeling richer, or just 
tired? It would have been better for 
Jeri if the coordinator had issued a roll- 





back instead of a commit. She could 
have kept her $100,000. Luckily, our 
scenarios are only fiction. This happy 
ending concludes our OTS story. 


CONCLUSION 
In addition to being important at the 
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system level, OTS will redefine the 
way that we build our client/server © 
middleware. For starters, it will en- 
courage developers to use transactions 
pervasively. Transactions are now part 
of the ORB. As a result, most objects 
that live on the ORB will be transac- 
tional. The ubiquitous use of transac- 
tions on the ORB will result in TP 
Monitors morphing into ORBs (or vice 
versa). This means that ORBs may 
very well be the next generation TP 
Monitor. 


Jeri Edwards, Dan Harkey, and Bob Orfali are 
authors of the Essential Client/Server Survival 
Guide (Wiley, 1994)—winner of the Jolt Cola 
Award for best book of 1994. Harkey and Orfali 
also wrote Client/Server Survival Guide with 
OS/2 (Wiley, 1994) and Client/Server 
Programming with 0S/2 (Wiley, 1993). Their 
latest book is The Essential Distributed Objects 
Survival Guide (Wiley, 1996). Both have been 
developing client/server applications and tools 
for the last nine years and are currently work- 
ing on the application of distributed object | 
technology. They are affiliated with [BM 
Austin, Tex. Edwards is the director of transac- 


tion processing and client/server software I 
development at Tandem Computers, Cupertino, \ 
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Searching for 

the Cure. 

Cancer sounds like such a 
grown-up disease, but each year, 
more than 6,000 American 
children will be stricken. 

The doctors and scientists at St. | 
Jude Children’s Research Hospital 
are working to wipe out cancer 
and other catastrophic childhood 
diseases forever. In fact, research | 
and treatments developed at St. 
Jude Hospital have already made 
childhood cancer a survivable 
disease for thousands of children. 

But until every child can be 
saved, the battle against cancer 
must continue. 

To learn more about the life- 
saving work of St. Jude Hospital, 
please call 1-800-877-5833. 
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Configuring DB2/2 for Novell's NetBIOS. 
By JEFFREY ALTMAN 


ast year, while working on the NET- 

BIOS interfaces in C-Kermit for OS/2 

communications software, | came 
across a friend who was having trouble in- 
stalling an IBM Database2 OS/2 1.2 
(DB2/2) server on a Novell Netware 3.11 
wide-area network of OS/2 and DOS work- 
stations. DB2/2 uses the NETBIOS Network 
application programming interface (APD to 
enable its servers to communicate with its 
clients on the DOS/Windows and OS/2 
plattorms. The problem was that clients on 
different subnets could not communicate 
with the server. 

The OS/2 workstations were using IBM 
Multi-Protocol Transport Services (MPTS) 
and Novell Netware Requester 2.11 to pro- 
vide network access. The DOS workstations 
were using a combination of Novell's 
Netware Client Kit for DOS/Windows and 
IBM Network Transport Services for DOS 
(NTS/DOS). All of the systems were using 
IBM’s implementation of NETBIOS for 
database network communication. 

In the years since its introduction in 
1984, NETBIOS has become a portable net- 
working interface that is independent of the 
underlying networking protocols (session 
and link layers). NETBIOS has been imple- 
mented on top of several protocols includ- 
ing, NETBEUI (the original protocol used in 
the IBM PC Network of the early ‘80s), IPX 
(the protocol used in Novell NetWare 
Networks), and IP (the protocol used on the 
Internet). 

The standard IBM implementation of 
NETBIOS uses the NETBEUI protocol. 
While this protocol is fast and easy to use, it 
does have several downsides. First, in- 
stalling a NETBEUI NETBIOS protocol on a 
DOS Netware client requires the purchase 
of additional software—NTS/ DOS. Second, 


DB2/2 Communication 
Using Novell’s 
NETBIOS Over IPX 


NETBIOS is implemented using a broadcast 
scheme, which requires that all packets be 
sent to all workstations. NETBEUI packets 
are not routable and, therefore, NETBEUI 
NETBIOS networks are difficult and expen- 
sive to configure on networks consisting of 
multiple subnets. 

Users of Novell Netware LANs have a 
wonderful alternative. They use NETBIOS 
over IPX instead of NETBIOS over NET- 
BEUI. IPX NETBIOS is included free of 
charge with the Netware Client Kits for 
both DOS/Windows and O5/2. By config- 
uring DB2/2 to use IPX NETBIOS instead of 
NETBEUI NETBIOS, installations with a 
large number of DOS/ Windows clients on a 
multiple subnet Netware LAN can avoid 
the expense of purchasing IBM Network 
Transport Services for DOS (NTS/DOS) and 
conserve DOS real-mode memory. 

In addition, IPX packets are routable, 
thereby avoiding the requirement that NET- 
BIOS Name Tables be maintained on each 
LAN segment by the routing equipment in 
order for NETBIOS Name collisions not to 
occur. This maintenance of synchronizing 
multiple name tables would require more 
expensive routing equipment and increased 
LAN traffic. 

On DOS/Windows clients, all NET- 
BIOS implementations regardless of vendor 
and underlying protocol use the Int 5Ch 
and Int 2Ah software interrupts to interface 
between the application and the NETBIOS 
driver. This enables any application to use 
any vendor's NETBIOS. Substituting one 
NETBIOS implementation for another is 
therefore a trivial exercise. 

In OS/2, NETBIOS is implemented via 
an API stored in a DLL. Unlike DOS, OS/2 
currently has two different standard APIs 
for implementing NETBIOS: “NETBIOS 
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Submit” and “NETBIOS 3.0”. This results in 
not every application being able to interface 
with every implementation of NETBIOS. 

DB? /? was written to use the NETBIOS 
3.0 API provided in the IBM MPTS package. 
Even though Novell provides [PX NET- 
BIOS, it can’t be used directly by DB2/2 be- 
cause it implements the NETBIOS Submit 
API. However, by installing both MPTS and 
NetWare Requester for OS/2 (NWR/2) on 
the workstation in a multiple-stack configu- 
ration, it is possible for DB2/2 to use the 
IPX NETBIOS services. 


THE NETBIOS 3.0 API STACK 

Under a normal installation of IBM MPTS, 
three NETBIOS-related files are installed: 
ACSNETB.DLL, NETBIOS.OS2, and NET- 
BEUI.OS2. The NETBIOS 3.0 API is imple- 
mented in ACSNETB.DLL. All programs 
that are developed to use the NB30 API 
must load this DLL at run time. NET- 
BIOS.OS2 provides a protocol-independent 
NETBIOS API called LM10. NETBEUI.OS2 
implements the Netbeui protocol, which is 
called by NETBIOS.OS2. The calling se- 
quence is shown in Listing 1. 


NOVELL’S NETBIOS SUBMIT API STACK 

The NETBIOS Submit API was originally 
developed as part of the IBM OS/2 
Extended Edition and then IBM OS/2 
Extended Services. NETBIOS Submit was 
just one of many communications APIs that 
were included in the original NETAPI.DLL. 
Novell adopted the NETBIOS Submit API 
and implemented its own version of NET- 
API.DLL with only NETBIOS support. 
Novell's NETAPI.DLL depends heavily on 
another DLL, NETSUB.DLL, which actually 
implements the NETBIOS Submit calls. 
NETAPI.DLL is just a compatibility layer. 
NETSUB.DLL, in turn, communicates with 
Novell's NETBIOS.SYS. NETBIOS.SYS im- 
plements a NETBIOS protocol using the 
Novell IPX protocol. The calling sequence is 
shown in Listing 2. 


IMPLEMENTING MULTIPLE 

STACKS WITH LM10 NETBIOS 

IBM’s LM10 NETBIOS specification (NET- 
BIOS.OS2) is protocol-independent and can 
implement NETBIOS interface across any 
protocol compatible with it. Novell's NET- 
SUB.DLL is programmed to look for NET- 
BIOS.OS2 prior to looking for NETBIOS.SYS. 








Therefore, when both products are installed 
on the same machine, calls to either NET- 
BIOS 3.0 or NETBIOS Submit interfaces 
would by default both share the IBM NET- 
BEUI protocol. 

NETBIOS.O82 can be configured to rec- 





Listing 1. The IBM MPTS NETBIOS protocol stack. 


Listing 2. The Novell Netware NETBIOS protocol stack. 





Listing 3. Multiple stack using IBM MPTS and Novell NETBIOS. 
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Listing 4. Four examples of using more than one protocol simultaneously. 


ognize more than one protocol. This 
allows each application to choose the 
appropriate protocol at run-time re- 
gardless of which NETBIOS API it 
was written to use. This is known as 
implementing a multiple stack. After 
proper configuration, the multiple 
stack could look like Listing 3. 
NETBIOS.O82 retrieves its con- 
figuration information from the PRO- 
TOCOL.INI file, which is stored in the 
IBMCOM directory created during 





Figure 1. D82/2 workstation directory catalog. 
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the MPTS installation. PROTO- 
COL.INI consists of sections identi- 
fied by driver names in square brack- 
ets followed by. configuration 
item-and-value pairs indented from 
the left margin. Most of the settings in 
PROTOCOL.INI are configured by 
using MPTS.EXE: , 

Without a configuration specified 
in PROTOCOL.INI, NETBIOS.OS2 
uses its default configuration to de- 
fine one Logical NETBIOS Adapter 
for each Physical Adapter 
Driver and bind NET- 
BEUI.OS2 to each of the 
logical adapters. 

This default configu- 
ration can be overridden 
by using a text editor, such 
as E.EXE, to add a [NET- 
BIOS] section to the end of 
the PROTOCOL.INI file. 
The format of this new sec- 
tion is: 


[NETBIOS] 

DriverName=NETBIOS$ 
<logical adapter>=<driver>, 
<physical adapter binding> 
[,<sessions> [,<commands> 
[,<names>]]] 
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“logical adapter>=<driver>, physical 
adapter binding> 
[,<sessions> [,<commands> [,<names>]]] 


where: <logical adapter> is ADAPTERO 
through ADAPTER9. The logical 
adapter numbers must be in sequence. 

<driver> is the protocol-specific 
implementation of NETBIOS. For ex- 
ample, “ipxnb$" for Novell IPX, "net- 
beui$" for IBM NETBEUI, or "tcpbeui$" 
for IBM TCP/IP. 

<physical adapter binding> is the 
binding order of the physical adapter 
driver (that is, IBMTOK_nif NE2000_nif) on 
the Bindings line in the NETBIOS 
<driver>*s (NETBEUI_nif or TCPBEUI_nif) 
section in the PROTOCOL.INI file. 
This value may range from 0 to 63. 
However, it is usually 0, since there is 
rarely more than one physical adapter 
installed in the machine. When used 
with the IPX NETBIOS, this value 
must be 0 because the ipxnb$ driver 
retrieves its configuration data from 
the Novell NET.CFG file and not 
PROTOCOL.INI. 

<sessions>, <commands>, and <names> 
are optional parameters which place 
an upper limit on the number of ses- 
sion, commands, and names that may 
be used by the <driver>. These values, 
if specified, must be greater than or 
equal to the settings in NET.CFG 
(Netware NETBIOS section) if <driver> 
is ipxnb$, or PROTOCOL.INI (Net- 
beui_nif or Tcpbeui_nif sections) if <dri- 
ver> is either netbeui$ or tcpbeuif. 

By assigning different NETBIOS 
implementations to different logical 
adapter numbers, it is possible to use 
more than one protocol simultane- 
ously. Four examples are shown in 
Listing 4. 


CONFIGURING IBM DB2/2 TO USE 


MULTIPLE NETBIOS IMPLEMENTATIONS 
To enable DB2/2 and the DOS/ 
Windows Client to use multiple logical 
NETBIOS Adapters, you must add the 
following line to your CONFIG.SYS 
and DBDROQLIB\DBDRQOLIB.CFG file: 


SET SQLNADPT=ALL 


This statement instructs DB/2 to ini- 
tialize or reset all NETBIOS adapters 
when it is started. Other valid values 
are 0, 1, or NONE. NONE tells IBM 
DB2/2 not to use NETBIOS at all, 
while 0 or 1 instructs it to use only 
that particular adapter. The default is 
0. DB2/2 can only access adapters 0 
and 1. Even though you can define 








Table 1. The fault values of various NETBIOS settings. 





Table 2. Maximum values of various NETBIOS settings. 


adapters 2 and 3 to NETBIOS.OS2, 
DB2/2 can not use them. 

To specify the number of client 
sessions that can be active simultane- 
ously on each NETBIOS adapter add 
the following line to CONFIG.SYS 
(DB2/2 Servers only): 


SET SQLNETB=xx, yy 
where xx is the number of sessions for 


Adapter 0 and yy is the number of ses- 
sions for Adapter 1. DB2/2 Server has 





an overhead of six sessions. Therefore, 
these values must be greater than or 
equal to six plus the number of clients 
that will attempt to maintain simulta- 
neous connections to the DB2/2 Server. 
If xx = 16, then the eleventh client that 
tries to connect to DB2/2 Server using 
the driver assigned to Adapter0 will 
not be able to connect. 


CATALOGING DB2/2 WORKSTATIONS 
ON NETBIOS NETWORKS 
NETBIOS workstations are defined 
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within DB2/2 by using the Directory 
Tool. Open the Workstation Directory 
and then choose Workstation Catalog 
(Figure 1). Choose a local name for 
the remote DB2/2 Server. Select a 
NETBIOS connection. Provide the 
NETBIOS name specified when the 
server was configured. Then, select 
the logical NETBIOS adapter upon 
which that server can be found. 
Remember, if the server is configured 
to use NETBEUI NETBIOS, a work- 
station configured to use IPX NET- 
BIOS will not be able to communicate 
with it. 


DB/2 NETBIOS RESOURCE 
REQUIREMENTS 

IBM DB2/2 requires the following re- 
sources from each NETBIOS protocol: 
4 names, 46 commands, and as many 
sessions as are specified in the SQL- 
NETB line in the CONFIG:.SYS file. If 
these resources are not available 
when IBM DB2/2 is started, NETBIOS 
connections will not be available for 
that adapter. 

The number of commands, ses- 
sions, and names must be configured 
separately for each NETBIOS protocol 
stack. NETBEUI NETBIOS is config- 
ured using MPTS.EXE. IPX NETBIOS 
is configured by editing the NET.CFG 
file. (See appropriate documentation 
associated with each product for fur- 
ther details.) 

The default and maximum set- 
tings for various NETBIOS implemen- 
tations are illustrated in Tables 1 and 
2. Because Novell NETBIOS defaults 
to 32 commands, a “Netware NET- 
BIOS” section must be added to the 
NET.CFG file. In that section, a “com- 
mands” statement should be placed, 
which increases the number of com- 
mands to at least 46. 

NETBEUI NETBIOS should en- 
able DB2/2 to support a greater num- 
ber of sessions than IPX NETBIOS. 
But the maximum values, shown in 
Table 2, are pipe dreams. Due to 
memory constraints within the NET- 
BIOS driver, it is unlikely that the 
maximum values could ever be used. 

Listings 5, 6, and 7 provide ex- 
cerpts from the configuration files of a 
system that has implemented the 
techniques previously described. 


CONCLUSION 

Having successfully configured our 

NETBIOS implementation for use 

with IBM DB2/2, we have expanded 

the range of use of our client server 
Continued on page 45 
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te ee eee SEE eee 
SET SQLNETB=16 


‘eWl,.w@ SET SQLNADPT=ALL 
¢) a ) =) 4) (| LIBPATH=. . .D:\MPTN\DLL;D:\ZBMCOM\DLL;. 
wit Gil 


D: \NWETWARE.211;L:\0S2;P:\0S2; 


— SET PATH=...D:\MPTN\BIN:D:\IBMCOM;... 
L | ( | t) 1) s, D: \WETWARE.211;L:\0S2;P:\0S2; 
‘\] / (le) mY SET DPATH=. . .D:\IBMCOM;... 

D: \NETWARE.211;D:\NETWARE.211\NLS\ENGLISH;L:\NLS;P:\WLS;... 
i Y 5 SET HELP=. . .D:\NETWARE. 21\NLS\ENGLISH; ... 
=) \ | ol] DEVICE=D: \IBMCOM\PROTOCOL\LANPDD .0S2 
DEVICE=D: \IBMCOM\PROTOCOL \LANVDD.0S2 
aon | DEVICE=D: \IBMCOM\PROTMAN.0S2 /'T:0:\IBMCOM 
( Min nn 210) 1 DEVICE=D: \IBMCOM\LANMSGDD.0S2 /I:0:\IBMCOM 
J t | bs L REM --- NetWare Requester statements BEGIN --- 

SET NWLANGUAGE=ENGLISH 
DEVICE=D: \WETWARE.211\LSL.5YS 
RUN=D: \NETWARE. 211 \DDAEMON . EXE 
REM -- ODI-Driver Files BEGIN -- 
DEVICE=D: \IBMCOM\PROTOCOL \ODI2NDI.0S2 
REM -- ODI-Driver Files END -- 
DEVICE=D: \NETWARE.211\IPX.SYS 
DEVICE=D: \NETWARE.211\SPX.SYS 
RUN=D: \NETWARE. 211\SPDAEMON. EXE 
DEVICE=D: \NETWARE.211\NMPIPE.SYS 
DEVICE=D: \NETWARE. 211\NPSERVER.SYS 
RUN=D: \NETWARE.211\NPDAEMON.EXE NPSERVERNAME 
DEVICE=D: \NETWARE.211\NWREQ.SYS 
IFS=0: \NETWARE.211\NWIFS .IFS 
RUN=D: \NETWARE. 211\NWDAEMON .EXE 
DEVICE=D: \NETWARE.211\NETBIOS. SYS 
RUN=D: \NETWARE. 211 \NBDAEMON. EXE 
DEVICE=D:\052\MD0S\LPTDD.SYS 
REM --- NetWare Requester statements END --- 
RUN=D: \IBMCOM\LANMSGEX .EXE 
DEVICE=D: \IBMCOM\PROTOCOL\LANDD .0S2 
DEVICE=0: \IBMCOM\PROTOCOL\LANDLLDD.0S2 
TRACEBUF=16 
DEVICE=D: \IBMCOM\MACS\IBMTOK .0S2 
RUN=D: \IBMCOM\PROTOCOL\LANDLL . EXE 
DEVICE=D: \IBMCOM\PROTOCOL \NETBEUT.0S2 
DEVICE=D: \IBMCOM\ PROTOCOL \NETBIOS .0S2 
RUN=D: \IBMCOM\PROTOCOL \NETBIND . EXE 















f = The best way to 
f find out what’s 
s available for 
IBM system 


| software 


it by browsing 
Listing 5. Excerpts from sample CONFIG.SYS file after installation of Novell Netware Requester 
this software and 2.11 and IBM MPTS. 





services directory of (NETBEUL_nif] NETBIOSTIMEOUT = 500 
NETBIOSRETRIES = 8 
ro : for Os DriverName = netbeui$ NAMECACHE = 16 
P ucts f /2, Bindings = IBMTOK_nif PIGGYBACKACKS = 1 
ETHERAND_TYPE = "I" DATAGRAMPACKETS = 2 
2% u = 350 
AIX and other USEADDRREV = "YES PACKETS 
DS2TRACEMASK = 0x0 LOOPPACKETS = 1 
SESSIONS = 48 PIPELINE = 5 
IBM supported NCBS = 190 MAXTRANSMLTS = 6 
| Be NAMES = 64 MINTRANSMITS = 2 
SELECTORS = 16 DLCRETRIES = 5 
operating systems. USEMAXDATAGRAM = "YES" FCPRIORITY = 5 
ADAPTRATE = 1000 NETFLAGS = 0x0 
WINDOWERRORS = 0 
MAXDATARCY = 16384 [NETBIOS] 
TI = 30000 
SpE RY Sees Sie DEN: Ti = 500 DriverName = NETBIOS$ 
OS/2 Magazine, and Software Development. 12 = 200 1D APTERO = pathenieso 
a 
4 MAKIN = 32 ADAPTER1 = ipxnb$,0 
OS/2" is a registered trademark of Find it MAXOUT = 64 
International Business Machines 0 n the 
Corporation and is used by Miller : ' | 
Freeman, Inc. under license. Web! Listing 6. Sample (NETBIOS] and [NETBEUL_nif] sections from PROTOCOL.INI file. 
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database applications without in- administrators or bearing additional It is important to note that the | 
creasing the burden on the network _ software expense. techniques used in this article to en- 
able DB2/2 to use IPX NETBIOS are | 
not limited to Novell's implementa- 
tion. They can also be used to allow 
DB2/2 to use IBM NETBIOS for 
TCP/IP or any other NETBIOS imple- 
mentation consistent with the LM10 
specification. Nor is DB2/2 the only 


-m . | : a Fe rs application that can take advantage of 
Listing 7. Sample “Netware NETBIOS” section from NET.CFG file. multiple NETBIOS stacks. Any NET- 





BIOS-aware application, which allows 
the specification of a NETBIOS 
Adapter, can take advantage of these 
benefits. This includes DOS and 
Windows applications running under 
OS/2. 
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designer at Columbia University’s Kermit 
Software Development Group. He has been 
developing cross-platform communication soft- 
ware on IBM OS/2 and other PC operating sys- 
tems for several years. He is currently pursuing 
a Ph.D. in Computer Science at Columbia 
University. His research topics include object- 
oriented techniques for distributing copy- 
righted or licensed information across hetero- 
geneous networks of computers. He can be 
reached at (212) 854-1344 or via Internet at 
jaltman@columbia.edu. 
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Some useful programming tips: implementing multiple columns and drag/drop features 
ina PM listbox. 
By MARK MCMILLAN 


A Multicolumn 
Drag/ Drop Listbox 





n the quest for ever easier user inter- 

faces, the listbox is a natural target for 

improvement in OS/2 PM. Mark Benge 
and Matt Smith described many listbox 
improvements in a series of articles starting 
in the January/February 1994 issues of OS/2 
Developer. Some of those improvements, 
most notably the removal of the 64-K data 
limit, were implemented in OS/2 Warp 3.0. 

Two particular concepts that they 
described, however, were never actually 
incorporated in their listbox replacement. 
(Hey, they are busy guys!) In this article, I 
will describe a custom PM control, which 
implements a true multicolumn listbox, and 
a subclass procedure, which performs drag- 
and-drop listbox reordering. These items can 
be used separately or together to create a 
multicolumn, drag-and-drop listbox. 

Unlike the Benge/Smith approach of 
writing a control from scratch, my tech- 
niques make extensive use of the existing 
PM listbox. The original concept of the 
MCLB was created by Charles Cooper of the 
IBM Warwick Development Group (IBM 
U.K. Ltd.). The drag-and-drop concepts were 
created by Allan Warren of IBM Yorktown 
Research. Working at IBM in Research 
Triangle Park, I rewrote both implementa- 


Figure 1. A multicolumn listbox with sizeable columns. 


46 


tions, added some features, and simplified 
the programming interfaces. 


SEEKING ROWS AND COLUMNS 

Applications often need to display data in a 
column format selectable by rows. 
Developers that prefer to avoid the complex- 
ity of the container control have tried vari- 
ous means to achieve a multicolumn effect 
with the listbox control. Common methods 
include using a fixed-pitch font so that char- 
acters align into columns or using an owner- 
drawn listbox with the application rendering 
the text of each item. Both of these methods 
have serious drawbacks in terms of visual 
presentation or code complexity. 

The multicolumn listbox control pre- 
sented here preserves the simplicity of the 
PM listbox but adds a visually pleasing mul- 
ticolumn capability, including proportional 
font support, movable column dividers, and 
column titles. 

A second common need for the listbox is 
to display a list of information in a specific 
order and allow the user to reorder the items 
or move them from one list to another. Many 
applications faced with this requirement 
resort to an elaborate set of pushbuttons or 
other controls to let the user move items 
within the list or between lists. The drag- 
and-drop function described here allows the 
application to easily support the drag and 
drop of items within a list (for reordering) or 
between lists (for moving or copying). 

The multicolumn and drag-and-drop 
listbox supports are independent of each 
other and can be used separately, or they can 
be combined to create a multicolumn drag- 
and-drop listbox. Both functions support 
“owner-drawn” listboxes for applications 
that need nontext listbox items such as 
bitmaps or other graphics. 
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MULTICOLUMN LISTBOX 
OVERVIEW 
A MultiColumn ListBox 
(MCLB) is a composite control 
consisting of a variable num- 
ber of listboxes, column sepa- 
rators, and column headings 
(Figure 1). The overall control 
organizes these components 
into a single user interface 
component. The control looks 
more like a container than a 
listbox from the user’s point of 
view. However, from a pro- 
grammer’s point of view, the 
MCLB is much more like a list- | 
box (and, in fact, uses the usual |B @agIMS: 
listbox messages). The user 
operates an MCLB much like a 
details-view container. Records 
can be selected, and the split- 
bars moved to change the rela- 
tive column sizes. When the 
user clicks on an item in any 
column of the MCLB, the 
entire record (row) is selected. 
A single vertical scroll bar on 
the right edge scrolls the 
records up and down. The 
MCLB can optionally have 
horizontal scroll bars at the 
base of each column. 

An MCLB comes in two 
basic styles: one with columns, 
which are sizable via splitbars, 





MultiColumn ListBox 





Sample #, 


Description 





and one with fixed-width Figure 3. An MCLB with bitmaps. 


columns and no split bars. 

Figure 2 shows an MCLB using 

fixed-width columns. Because the MCLB is 
based on the real PM listbox control, any of 
the usual listbox styles can also be used with 
an MCLB, such as LS_HORZSCROLL to place hori- 
zontal scroll bars at the bottom of each col- 
umn or LS_MULTIPLESEL to allow multiple 
record selection. LS_OWNERDRAW style is also sup- 
ported if the application wants to draw non- 
text items into one or more columns, such as 
the bitmaps shown in Figure 3. The MCLB 
supports any number of columns, but per- 
formance decreases in a linear fashion as the 
number of columns increase. 

Columns can be resized by positioning 
the pointer over a splitbar and dragging it to 
a new position. The columns adjacent to the 
splitbar are then resized (other columns are 
unaffected). The Alt-arrow keys can be used 


to move the splitbar with the Ctrl-arrow 
keys moving from one splitbar to the next. 

Each column of an MCLB shrinks or 
grows in proportion to its relative size when 
the MCLB window is resized. For example, if 
a column was 20% of the width of the MCLB 
before resizing the window, its width would 
be automatically adjusted to remain 20% of 
the window size. This resizing algorithm can 
be modified through the use of style flags. 

The MCLB supports the use of the sys- 
tem font and color palettes to allow drag and 
drop of fonts and colors. An MCLB can use 
different fonts and colors for the column 
headers and the data records. All columns 
are updated to use the same font or color 
when a font or color is dropped on an MCLB 
column. 
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Listing 1. MCLB initialization structure. 


The application can respond to 
user selections, de-selections, and the 
ENTER key like a normal PM listbox. 


PROGRAMMING AN MCLB 

If you are familiar with the PM list- 
box, then you already know most of 
what you need to use an MCLB. The 
MCLB uses the usual listbox messages 
for inserting text (LM_INSERTITEM) and 
for determining selection status 
(LM_QUERYSELECTION). A few differences 
exist, however, in creating an MCLB, 


Listing 2. Creating an MCLB in a dialog. 





and some additional control messages 
are generated. 

From a programming viewpoint, 
the MCLB is logically a single listbox. 
Each listbox item represents an entire 
row of the MCLB. When an item is 
selected in the MCLB, the entire row is 
highlighted and considered selected. 
Items in a listbox are addressed by their 
zero-based index (position in the list). 
This index corresponds to the zero- 
based row number in an MCLB. When 
the application queries the text for item 
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5, for example, the MCLB returns a sin- 
gle string, which represents all the text 
in row 5, and each column’s text is 
delimited with a separator. 


CREATING AN MCLB 

The application must first create a data 

structure with the MCLB initialization 

data, including specifications for the 

number of columns, column titles, a 

separator character, and style flags. 

Listing 1 shows the MCLBINFO data struc- 

ture that the application constructs. 

The application then calls MCLBCreate- 

Window(), passing the usual window- 

creating information such as window 

size, parentage, and the MCLBINFO struc- 
ture. A window handle is returned if 
the MCLB is successfully created. 

Most of the fields of the MCLBINFO 
structure are obvious, but a few benefit 
from some explanation: 
¢ The TabChar field contains a single 

non-null character that will be 
to separate the column data in a sin- 
gle record. As will be discussed 
later, each record of the MCLB is 
logically a single string, with this 
character used to separate the data 
into columns. 

* The /InitSizes/ field is a pointer to an 
array of LONG values. There must be 
as many elements of this array as 
there are columns specified in the 
/Cols/ field. These values establish 
the initial size (width) of the 
columns and are relative for an 
MCLBS_SIZEMETHOD_PROP-style MCLB, 
since the columns will be propor- 
tionally expanded to fill the width 
of the control. For example: 


LONG ColSizes[3] = {2L, iL, iL}; 


will create a listbox in which the 
first column is twice the size of the 
second and third columns. The ini- 
tial size values define the pixel 
widths of the columns for a style of 
MCLBS_SIZEMETHOD_LEFT. Any 
leftover space will be given to the 
left column. 

The MCLB does not currently 
support direct creation from a dialog 
template. However, it is very easy to 
get the same effect by defining a static 
rectangle (or any other control) in the 
dialog template to act as a placeholder. 
Listing 2 shows a WM_INITDLG sequence 
used to create an MCLB and then 
replace a static dialog control with it. 


MCLB ITEM STRINGS 
In keeping with the listbox program- 
ming, model, each item (record) in the 


Table 1. MMCLB messages. 


MCLB control has a single text string 
associated with it. The string defines 
the text that is displayed on that row 
of the MCLB. A single separator char- 
acter is used to delimit where the text 
for each column begins and ends in the 
string. The separator can be any binary 
value except zero and is specified in 
the MCLBINFO structure when the MCLB 
is created. 

Text strings are assumed to contain 
the separator characters when inserting 
or setting text in the MCLB. A null 
(empty) column is denoted by two adja- 
cent separator characters in the string. 
For example, the following item strings 
could be used for a 3 column MCLB 
with a / (slash) for the separator: 


John//Smith 
Steve/A/Campbel1 


Eric 


The MCLB always returns fully 





delimited item strings when text is 
queried. The previous sample would 
be returned from an LM_QUERYITEMTEXT 
message as: 


Eric// 


INSERTING RECORDS 

Inserting items in an MCLB is 
done with the standard PM listbox 
messages. The listbox insert messages 
are extended with an extra field to 
specify the column for sorting. The 
extension is done by using part of the 
message parameters that are unused 
by the standard PM listbox messages. 
Here is an example of a new record 
inserted into a three-column listbox. 
The record is inserted so that the third 
column remains in sort order: 


WinSendMsg(MCLBHwnd, LM_INSERTITEM, 
MPFROM2SHORT(LIT_SORTASENDING, 3), 
MPFROMP("Steve/A/Campbell")) ; 
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ress 


This extension is defined for the 
LM_INSERTITEM and LM_INSERTMULTITEMS 
messages. 


MCLB NOTIFICATIONS 
The MCLB control generates all of the 
usual listbox WH_CONTROL notification 
messages such as LN_SELECT and LN_ENTER. 
In addition, the MCLB control gener- 
ates some new messages to notify the 
owner of MCLB-specific events: 
© MCLBN_COLSIZED is generated when the 
user changes a column size by using 
a splitbar. 
© MCLBN_CUSTOMSIZE is generated when 
the MCLB window is resized and 
the MCLBS_SIZEMETHOD_CUSTOM style is 
used. The application responds by 
setting the new sizes for all the 
columns. 
© MCLBN_PPCHANGED is generated when a 
presentation parameter (fonts or col- 
ors) in the MCLB has been changed. 
It is sometimes useful to know 
which column of the MCLB caused the 
generation of a particular notification 
message. The application can send the 
MCLB an MCLB_QUERYCTLCOL message to 
determine which column caused the 
WM_CONTROL message. This query must be 
sent (not posted) while the application 
is processing the WH_CONTROL message. 


MCLB MESSAGES 

All the usual listbox messages (LM_*) 
may be sent to the MCLB. The listbox 
messages can be used to select items 
(rows), query the text, query the 
selected items, change the text of an 
item, or set/query item handles. 

The MCLB supports some addi- 
tional messages for MCLB-specific 
functions plus the standard listbox 
messages. Table 1 lists all these MCLB- 
specific messages that can be sent to an 
MCLB. These include messages to set 
fonts and colors for the titles and data 
lists, setting new title strings, and 
querying various information about 
the size and status of the columns. 


OWNER-DRAW MCLB 
The MCLB control supports owner- 
drawing of the data columns. The 
application is responsible for drawing 
all the rows and columns of the data 
items of an MCLB with the LS_OWNERDRAW 
style. (This style cannot be applied to a 
single column.) LS_OWNERDRAW can be 
used when the application wants to 
draw nontext items in one or more 
columns of the MCLB. 

The owner of an owner-draw 
MCLB will receive WM_MEASUREITEM and 
WM_DRAWITEM messages just like a stan- 
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Listing 3. Processing WA_DRAWITEM for an MCLB. 





Figure 4. Use of drag/drop listboxes. 


dard PM owner-draw listbox. These 
messages will occur for each row and 
column of the listbox. (This is one 
place where the single listbox pro- 
gramming model does not apply.) 
These messages normally carry the 
item index in the first SHORT of mp1. 
The message is extended for an MCLB 
to carry the column number in the sec- 








ond SHORT of mp1. The 
application can examine 
both parts of mp1 to 
determine which row and 
column is to be drawn. 
Listing 3 shows the 
processing of a WM_DRAWITEM 
message for a two-col- 
umn MCLB,. The MCLB 
item handles are used to 
keep a bitmap handle in 
this sample application 
(SAMP2 in the toolkit 
SAMPLES directory). 
_ This handle is then used 
to render the bitmaps for 
column 1 during WM_DRAW- 
ITEM processing. For column 2, the 
sample just returns FALSE from WM_DRAW- 
ITEM, so the MCLB will draw the item 
text as usual. (The application must 
still properly handle the WM_MEASUREITEM 
message for column 2 even though it 
is drawn by the MCLB.) 
Gaining access directly to the 
underlying listbox window of the 
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MCLB may be necessary for some 
owner-draw functions. The MCLB cre- 
ates the column listboxes with an ID, 
which is the same as the column num- 
ber (1 based). To get the handle of the 
column 2 listbox, the application can 
use: 


Col2Hwnd = WinQueryWindowFromID 
(MCLBHwnd, 2); 


The window handle can be used to 
obtain a presentation space. The pre- 
sentation space can then be used for 
WinDrawText (...DT_QUERYEXTENT) to accu- 
rately measure the size of text strings 
in the listbox. 


DIRECT-MANIPULATION LISTBOX 

The Direct-Manipulation ListBox 
(DMLB) is another extension to the ba- 
sic PM listbox. The DMLB is a sub- 
classing of a listbox and is unlike the 
MCLB, which is a composite custom 
PM control. 

Applications often need to present 
a list of items in which the order of the 
items is significant. The listbox (or 
MCLB) control can be used to present 
such an ordered list. However, the 
user interface becomes more difficult if 
the application needs to provide a 
means for the user to specify a new 
ordering. Typically an application 
would have to resort to a series of 
pushbuttons and multistep user inter- 
actions to let the user reorder items in 
the list. The user interface is often 
clumsy and requires many user inter- 
actions to do significant reordering of 
the list. 

Some applications also need to 
allow the user to move items from one 
listbox to another. For example, a data- 
base export program might present a 
list of fields in the database and let the 
user choose the fields to be exported. 
The exported list of fields appears in 
another listbox. Applications typically 
provide insert/delete or move buttons 
between the listboxes to let the user 
move items back and forth between 
them. Again, the user interface is not 
always intuitive and requires several 
interactions to control it. 

The DMLB addresses these prob- 
lems by adding easy-to-use drag-and- 
drop capability to the listbox (or 
MCLB) control. The user can drag a 
listbox item to a new position in the 
same list or to another list. The appli- 
cation controls what happens when 
the user drops the list item (the item is 
moved, copied, or deleted). The listbox 
can be scrolled while dragging by 


moving the drag pointer above or 
below the listbox. 

Figure 4 illustrates how a DMLB 
is typically used in a database applica- 
tion. The left listbox shows all the 
fields in the database, and the right list 
shows the fields selected for exporting. 
The user can drag-and-drop reorder 
the right list to change the order of 
exported fields. He/She can also drag 
fields from the left list and add (copy) 
them to the right one. Dragging a field 
from the right list to the left deletes it. 
With the DMLB, the user is able to eas- 
ily choose database fields and order 
them for exporting without any addi- 
tional dialog controls or complex user 
interactions. 


PROGRAMMING THE DMLB 

The Direct-Manipulation ListBox is not 
a custom control but rather a subclass- 
ing of the standard PM listbox. Thus, 
an application first creates the listbox 
in the usual fashion and then calls the 
DMLBInitialize() API to establish the 
subclass and initialize the DMLB 
instance data. Listing 4 shows how a 
listbox control is set up for direct 
manipulation during WM_INITDLG pro- 
cessing of a dialog. 


The DMLB 
subclass, as imple- 
mented, will use 
the listbox window 
words (QWL_USER) for 
a pointer’ to 
DMLEB-related in- 
stance data. The 
listbox window 
words are not 
available for appli- 
cation use. How- 
ever, the DMLB 
reserves the first 
PVOID of its own 
instance data for 
application use. 
The application 
can use the first 
PVOID of the DMLB 
instance data if it 
needs to associate 
data with the list- 
box control. 

The drag-and- 
drop listbox sup- 
port involves a 


HWND = ListHwnd; 
PVOID +DMLBData; 
\W4_INITDLG: 
// Get handle of listbox control 
ListHwnd = WinWindowFromID(hwnd, ID_LISTBOX); 


// Setup subclassing for drag/drop support, resources 
// are bound to the EXE file 


DMLBInitialize(ListHwnd, NULLHANDLE); 


// Use DMLB instance data to store data we need to associate 
// with the listbox. First PVOID of DMLB area is ours to use. 


DMLBData = WinQueryWindowPtr(ListHwnd, QWL_USER); 
+DMLBData = MyListData; 


//... remainder of dialog initialization ...// 


return (MRESULT)TRUE; 
} 


Listing 4. Setup of a drag-and-drop listbox. 


simple message protocol between the 
source listbox (where the drag origi- 
nates) and the target listbox (where the 
user drops the item). The source and 


target may be the same listbox. When a 
listbox item is dragged over a listbox 
window, the potential target window 
is “probed” to determine if an item can 
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WH_CONTROL Code Description 
LN_DMLB_DELETE Item is about to be deleted (current selection). 
LN_OMLB_DELETE_MOVE Item is to be deleted for moving to another listbox. 
LN_DMLB_REORDERED An item was moved within the same listbox. 
LN_OMLB_INSERT_MOVE Item was inserted via drag: MOVE (current 
LN_DMLB_INSERT_COPY Item was inserted via drag: COPY (current 
selection). 
LN_OMLB_QRYDROP A drop is about to occur on this listbox, return 
OK-to-drop flag and drop-mode flags 
| (move/copy/delete). 


Table 2. DMLB noti fication messages. 


be dropped on it. The target responds 
to the probe with various codes; it can 
refuse the drop, or if the drop is 
allowed, the target will decide if the 
drop is to be a move, copy, or delete of 
the original item. The mechanics of the 
dragging and probing is automatically 
done by the DMLB subclass proce- 
dure. The application only needs to 
respond to a few WM_CONTROL notification 
messages. 

The complete list of DMLB notifi- 
cation messages is shown in Table 2. 
To implement a simple drag-and-drop 
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re-ordering capability in the listbox, 
the application needs to respond only 
to the LN_DMLB_QRYDROP message. Listing 5 
shows the processing of this message. 
The listbox will accept drops on itself 
for reordering items but refuses drops 
from any other listboxes. 

The owners of the source and tar- 
get listboxes will receive messages 
when items are moved, copied, or 
deleted by drag-and-drop methods. 
The application can ignore these mes- 
sages, if they are not of interest, or 
process them as required. For example, 
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the application may use the listbox 
item handles to keep track of dynami- 
cally allocated data for each item in the 
listbox. The application will want to 
process the LN_DMLB_DELETE message to 
free the data when the item is deleted 
due to a drag-and-drop operation. 


DMLB CONTEXT MENUS 

Another useful feature of the DMLB 
subclass is the ability to notify the 
owner when the user requests a con- 
text menu. The DMLB subclass will 
send the owner an LN_DMLB_CONTEXT mes- 
sage along with the index of the item 
on which the context menu was 
requested. Therefore, the application 
can provide direct actions on listbox 
items via context menus. Figure 5 is a 
listbox with a context menu for adding 
new items, editing items, and deleting 
items. 


DRAG-AND-DROP IMPLEMENTATION 

The current DMLB subclass uses a pri- 
vate drag-and-drop message protocol. 
It is designed so that a drag of a listbox 
item over a listbox, which is not sub- 
classed with the DMLB, will result in a 
“no-drop allowed” condition. The 


DMLEB subclass handles capture of the 
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case WA_CONTROL : 
switch SHORTIFROMMP(mp1) { 
case ID_LISTBOX: 
| switch (SHORT2FROMMP(mp1)) { 


case LN_DMLB_QRYDROP: 


// Control notification 


// From drag/drop listbox 


// If dropping in same listbox, move the item. If drop is 


// from some other listbox, refuse it. 


if (HWNDFROMMP(mp2) == WinlWindovFromED(hwnd, ID_LISTBOX)) 
return MREROM2SHORT(TRUE, DROPNODE_MOVE) ; 


return MRFROM2SHORT(FALSE, 0); 


Listing 5. Processing LN_DMLB_QRYDROP message. 


F4 Simple Drag/Drop Listbox 


Listbox item 6 
|Listbox item 1 
\Listbox item 2 
\Listbox item 3 
\Listbox item 4 
Listbox item 5 


Listbox item 7 
Listbox item 68 | 


Figure 5. Listbox context menu. 


mouse pointer, sets the shape of the 
pointer, and probes the window under 
the pointer to determine suitability for 
dropping. 

The DMLB subclass does not use 
the PM Orgdrag() API to implement the 
drag-and-drop functions. The advan- 
tage of this implementation is code 
simplicity (no complex drag data 
structures or message protocols), 
thereby allowing the owner of the list- 
box to respond to a very simple set of 
drag-and-drop messages. The disad- 
vantage of this approach is that it pre- 
cludes integration with the Workplace 
Shell. For example, a listbox item can’t 
be dragged to a WPS folder. The 
intended scope of the DMLB subclass 
is only to support drag and drop on 
listbox class objects. 


SUMMARY 

The MCLB and DMLB provide 
Presentation Manager applications 
with intuitive and visually clean exten- 
sions to the common listbox control. 
Implementation in existing or new PM 
applications is made quick and easy by 





the use of the familiar listbox 
programming model. With a 
minimal amount of code or 
programmer training, an appl- 
ication can provide a sophisti- 
cated user interface with tabu- 
lar data and/or drag-and- 
drop features. A complete 
toolkit, including full source 
code, online programming ref- 
erences, and working samples 
is available. 


Mark McMillan /s an advisory 
engineer with IBM's Networking 
Software Division at Research 
Triangle Park, N.C. He received his B.S. at the 
University of Michigan and completed his M.S. 
in computer engineering at Duke University. 
McMillan is currently developing user interface 
components for IBM’s Personal Communica- 
tions software products. 
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Opt-Tech Sort/ Merge 


High Performance Sort/Merge/Select Utility 
Use as a stand-alone utility or call as a Subroutine. Many 
features including unlimited file size, multiple keys, record 

selection, duplicate elimination, summing and more! 
Call for free brochur Opt-TechData Processing 
P.O. Box 678 
Available for: Zephyr Cove, NV 89448 
OS/2 or Unix $249 Phone (702) 588-3737 
DOS or Windows $149 Fax (702) 588-7576 
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PrntScrn Screen Image Utility 
by MITNOR Software 
4 Integrated Utilities for 1 Economical Price 
* Screen Printing/Screen Capture 
8 Capture methods/7 File Formats 
Print to Local or LAN attached printers 
* Clipboard Viewer with Import, Export & Printing capabilities 
* Screen Saver with 9 Dynamic Display Types 
* Date & Time Information Bar 


Available From 
Indelible Blue 1-800- 776-8284 
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Network Remote Control And Monitoring 
Help Desks Automated Agent + esol 


PM/Pirate 


Named Pipes 

TCP/IP 

Lowest network load ital Communications Sol. 
Record and Playback oS Cedar Rapids, ane sa 


All PM Video Modes in snk anapel on come emai 
No Special Drivers : 


FAST! 


‘ internet Service provider and Client Software. 
Automated Cycling Presentation Manager Development and Consulting 


$89.00 + san (800) 701-7205 
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agre SmartLink and Lotus Notes: 
A Winning Combination! 


In today's computer world, communicating effectively and quickly could 
be the difference between your company being a dead company or being a 


F save. quick company. 


Using Lotus Notes within your company, gives your company the ammu- | 


nition it needs to be a quick company. 


Now, Jagre, Inc. provides your company with the competitive advantage 


to being -- and staying -- a quick company: Jagre SmartLink. 


Jagre SmartLink is a set of Lotus Notes-enabled tools grouped together 
in one place to empower your IBM OS/2-based desktop applications to 
communciate effectively and quickly with Lotus Notes for Document 
Management, E-mail, Fax, Pager, OCR, Voice, Video, and User-based 
Agents to gets tasks done quickly. 


With Jagre SmartLink, the powerful features of Lotus Notes are now a button | 


click away! 


Click on any Jagre SmartLink tool for instant access to Lotus Notes, Now, 
you can use Lotus Notes and the Lotus Notes Companion Products with your 
desktop applications to communicate quickly with someone down the hall or 
across the world! 


Now, your ammunition arsenal is complete with Jagre SmartLink and their 


arsenals are not!! 
|S agre WYiins al) 


For a free demonstration copy of Jagre SmartLink to discover how it can 
help your company be a quick company, not a dead company, call or 
write Jagre, Inc. at (617)424-8302, 102 Gainsborough St. #202E Boston, 
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Right now you could be reaching 
more than 36,000 product-buying 
OS/2 Developers! 


Clair Bright 
(415)905-2544 
cbright@mfi.com 


TRACK ‘em DOWN!" 


oH; Customize: 
* Bugs, Change Requests « Reports 
* Projects, Code Changes »* Queries 
¢ Customer Calls and more * Forms & fields | 


Automatic Notification: Nothing falls through the cracks 
Integration with Version Control: Link files to bugs & bugs to files 
Multiple Linked Databases: Track bugs, customers and more 
Industry Standard Databases: Access from other applications 


“ sOFFRONT FREE working DEMO! 


Software Inc. 1-800-763- oe ae. 263.2703 
238 S. Hillview Drive, Milpitas,CA 95035 Fax: 408.263.7452 
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It’s easy 
to integrate 
business graphics 
into your 
OS/2 PM 
or 
Windows 3,NT,95 
applications 


Developer’s Business Graphics Toolkit 


® High-level APIs ® Dynamic Link Library 
® Tactile feedback ® Positive/negative data 

® Real-time charting © Printer/metafile support 
® 16-bit and 32-bit @ 25+ chart types 


The Crossley Group 
P.O, Box 921759 
Norcross, GA 30092 
USA (770) 751-3703 
Int'l 44-932-844-261 
{damo availabla) 
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VisualAge & PARTS 
Spreadsheets, business graphics, tables, and other powerful controls 
are are easy to add to your VisualAge™ and PARTS™ applications. 
WidgetKit™/Professional provides spreadsheets, tables, virtual 
spreadsheets, spreadsheet designer, load and save, printing, and more. 
WidgetKit/Business Graphics has versatile graphs and charts. | 
Subpanes/V for PARTS has a powerful table pane, columnar list box, 


| heirarchical list box, 3-D frames, 3-D and bitmap buttons, and more. 


No royalties for end-user applications, 90 days free support, and 
30-day money-back guarantee. Call or fax for free info. 


Objectshare Systems, Inc. _v: 408.970.7280 f: 408.970.7282 
2 Town & Country Village, Suite 773, San Jose, CA 95128 


Circle Reader Service Number 27 





» Building A 
Better Desktop 


fhe Award-Winning, Multi-Function Desktop Enhancements for OS/2” 


Presenting the DevTech Family of Productivity Tools for the OS/2 User. 


¢ Manage, secure, and customize your OS/2 
environment like never before! 

* Provide personalized desktops for each user. 

¢ Switch between as many as 81 “virtual 
desktops"—like having up to 81 monitors that 
all fit ight on your desk! 

« Save and restore entire system configurations. 


Best selling DeskMan/2 is the award-winning enhancement for all 
personal and corporate OS/2 users. This comprehensive, flexible, one- 
of-a-kind suite of multi-function tools makes it easy to use and administer 
OS/2, from the standalone PC to the LAN! Install, configure, backup, 
secure, and otherwise manage desktops locally or remotely. Enhance 
productivity with virtual desktops and Workplace Shell Extensions. 
Authorize access to individual DeskMan/2 and Workplace Shell 
features on a user by user basis. Take complete control of the WPS 
via a simple drag & drop interface, or a powerful API (including full 
support for REXX, CID and LAD/2). Review after review concludes 
that DeskMan/2 is a “must have” for all OS/2 users. IBM even features 
DeskMan/2 in its own “Red Book” on WPS configuration. Why not find 
out for yourself? 


« Al] new version! 

* Now twice as fast and ultra reliable! 

¢ Real world compression > 2.5:1. 

« No pre-allocation required - dynamic space 
management. 

* Unique disk server architecture. 


| | 
| Developement Techmobogies, Ine. | 


DCF/2 brings the power of a disk server architecture, usually found 
only on expensive mainframes and high-end minicomputers, down to 
your OS/2 desktop or notebook machine. Use HPFS without having to 
repartition or reformat your existing hard drive; DCF/2’s unique 
architecture allows it to create virtual HPFS drives anywhere that 
OS/2 can create a file: FAT partitions, floppy disks, removable hard 
drives, Novell servers, LAN Server volumes, you name it—DCF/2 
volumes go anywhere! Plus, DCF/2 volumes grow and shrink as needed 
so you don’t need to pre-allocate disk space! Copy entire HPFS virtual 
drives between computers as easily as copying a single file. New “After 
Image Journaling” technology brings even more mainframe 
power to the PC, and gives DCF/2 the most reliable data storage you 
can buy for OS/2—even surviving power failures! 


¢ DeskMan/2 v1.51b pilus FREE upgrade to 
DeskMan/2 v2.0 (when available). 

* DCF/2 Lite™- The “on the fly” data 
compression for OS/2. 

« The Graham Utilities for OS/2, Limited 
Edition* - Special selection of disk utilities. 

¢ Relish® v2.12 - Award-winning calendar, 
reminder & personal planner for OS/2. 

¢ CPU Monitor Plus™ Special Edition* - 
professional OS/2 performance monitor 
and analysis package. 


“Special Editions created 
exclusively for the 
Productivity Pack. 


Take the award-winning DeskMan/2 product; include features 
previously available only to corporate users, such as enhanced 
security and Workplace Shell auditing; add a leading edge selection 
of invaluable OS/2 utility products; and top the whole thing off with an 
incredible array of upgrade offers—that is the essence of the wildly 
successful DeskMan/2 Productivity Pack! This is one-stop-shopping 
for all your essential OS/2 needs, and has been called nothing less 
than “the OS/2 Survival Kit!” 


A THE ¢« Comprehensive suite of disk, file and general 
purpose utilities. 

« The only LAN compatible disk recovery tools 
for OS/2! 

¢ Edit, manage and repair local and remote disk 


QOSs/2 2 
Ooss2= 
OS/2 drives. 

Os/2 ¢ Restore corrupt partitions, recover lost data, 
: | 


diagnose system problems. 
e Much, much more — 50+ modules in all! 


The Graham Utilities is the most comprehensive suite of disk, file and 
general purpose utilities available for OS/2. This powerful suite contains 
tools that range from system diagnostics, to file and disk management, 
to helping you deal with the Internet. Recover lost data, undelete 
files, edit, manage and repair disk drives — even remote disk drives 
on LAN Server, LAN Manager, Lantastic and Novell Netware! The 
package includes an extensive 300+ page printed manual detailing 
all aspects of the product and its use, complete on-line documentation 
for easy access, and the unique Graham Integrator that literally walks 
you through the entire suite. A “must have” for every OS/2 user! 


"DeskMan/2 dramatically improves the ability of corporations and users 
to get the most out of OS/2. DeskMan/2 helps administrators restrict 
and control what users are doing and provides robust backup/restore 
features and seamlessly enhances the features of the WPS" 


Dr. Mike Kogan: Lead Architect of OS/2 2.0 
Author: The Design of OS/2 


“I can't imagine being without it.” 
Dave Barnes, IBM 
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Don’ t et the dark forces of ignorance 
defeat you. Right in this galaxy, you can 
tap into the source -- the free Consumer 
Information Catalog. It 

lists free and low- 


cost government 
publications . 


oncosmic : 

topics such as 

| federal benefits, 

jobs, health, housing, sisi your 


children, cars, and much, much more. So — 


dispel the darkness and send for the 
source. Write today to Pueblo, Colorado 
for the free Consumer Information Catalog. 
Just send your name and address to: 
. Consumer Information Center 
Department Source ‘. .- 
daira use 81009. -. 
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= OpenDoc gives developers a whole new way to create applications. Here’s a great way 
to leverage multimedia technology. 
By SCOTT BROUSSARD 


Accessing Multimedia 
Data from OpenDoc 





Scott Broussard 


ow that OpenDoc has given ap- 
plication developers a new com- 
# ponent-based platform in which 
to develop applications, and multimedia is 
starting to find its place in mainstream ap- 
plications, the first thing a developer needs 
to do is understand how to leverage multi- 
media technology, such as digital audio, 
and embed it in an OpenDoc compound 
document. 





ABOUT STORAGE UNITS 

OpenDoc uses a compound document tech- 
nology, called Bento, to store the data of var- 
ious types of component parts in a docu- 
ment. The OpenDoc run time reserves an 
area of the compound file for use by each 
part, called a storage unit. The OpenDoc pro- 
gramming interfaces provide a class called 
ODStorageUnit that encapsulates the compo- 
nent’s access to the Bento file. Within each 
storage unit, there is a set of properties, 
where each property has a set of values. 
Listing 1 shows the architecture of the stor- 
age unit. 

Properties and Values have names that 
are strings. These names are frequently [SO 
Strings. ISO Strings are scoped names that 
contain various substrings delimited by 
colons to ensure that they are unique across 
any domain in which they need to be 
unique, These substrings generally contain a 
company or organization name. For exam- 
ple, “IBM:SamplePart:Kind" is an ISO string that 
could be used as a Property or Value name. 

Access to data within a storage unit is 
similar to access to data within a traditional 
data file, although some key differences do 
exist. 

The ODStorageUnit class needs to maintain 
control over its internal structures, and 
therefore, provides Lock() and Unlock() func- 


tions to ensure that several threads don’t try 
to access the same storage unit concurrently. 

The O0DStorageUnit class has the notion of 
Focus-ing a particular Property and Value 
pair with the Focus() method. This allows the 
other methods on the storage unit to operate 
on a particular segment of data. Only one 
Property and Value pair can have the focus 
within the storage unit at one time. 
Therefore, it is essential to lock the storage 
unit while accessing data, so that no other 
threads change the context of the storage 
unit. 

The ODStorageUnit class allows the appli- 
cation to determine if a particular Property 
or Value exists without causing an error. 

Data can be read from the storage unit 
with the GetValue() method and written with 
the SetValue() method. These methods access 
the data at the currently set offset, which can 


+-Storage Unit-----~- 
| +-Property 








Listing 1. Storage unit architecture. 
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be modified with Set0ffset(). It is important 
to note that when the Property loses the 
focus, the offset is reset. 


ABOUT MULTIMEDIA 10 

If an application component, such as a per- 
sonnel information manager record that con- 
tained embedded audio, wanted the multi- 
media subsystem to access the data directly, 
without having to shuffle the data back and 
forth from a simple file and a storage unit of 
a compound document, the application 
would want to use a Multimedia IO (MMIO) 
Storage System IO Procedure. 

The multimedia programming inter- 
faces are set up to primarily deal with files 
that contain the common multimedia data 
formats, such as .WAV or .AVI. Fortunately, 
the MMIO Manager is organized into both 
File Format IO procedures, which manipu- 
late the layout of the data, and Storage 
System IO procedures, which manage where 
the data is stored. This allows data to be 
stored in either files or memory, or in the 
case of OpenDoc, in Properties of a storage 
unit that are reserved from the component. 


| Multinedia subsystem | | Applications | 
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| Multimedia IO Manager 
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Listing 2. Multimedia |O Procedure architecture. 


Listing 2 shows how the MMIO 
Manager layers its IO Procedures to allow 
the data to be stored anywhere but still uses 
the same code to manipulate the layout of 
the data. 

By writing a MMIO Storage System IO 
Procedure, the OpenDoc component handler 
that is using multimedia data types within a 
compound document can use the existing 
multimedia subsystem transparently with- 
out making any modifications or doing any 
of the basic work itself. As in Listing 3, it can 
implement an IO Procedure that uses the 
ODStorageUnit object to store and retrieve the 
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multimedia data from within the compound 
document. 


USING THEM TOGETHER 

In order to begin thinking about an 
OpenDoc Storage Unit IO procedure for 
MMIO, it is necessary to understand that the 
multimedia programming interfaces are 
used to dealing with media object names, 
which are usually file names. 

The MMIO manager identifies which 
Storage System IO Procedure should be used 
based on the syntax of the media object 
name. Simple file names and paths are di- 
rected to the DOS Storage System IO 
Procedure, which uses OS/2 File System 
APIs to implement the necessary functions. 
If the media object name is a file name with a 
+’ sign and an element name, then the BND 
(Bundled or compound) file Storage System 


eee ee ee ee a ee ee eee 
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| | +-Value----------------------~------+ | | 
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Listing 3. Multimedia OpenDoc Storage Unit 
architecture. 
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ES aaa 
FOURCC+ssssssss*PropertyName+ValueName. Extension 


| Listing 4. Sample media object naming syntax. 


IO Procedure is used. The Bundled file 
is a legacy compound file format that 
is built into MMIO, but it shouldn't be 
confused with the OpenDoc com- 
pound file, as they are different things. 
If no media object name at all is given, 
and a memory block is provided, then 
a memory file will be used. 

The media object name is the key 
to making the MMIO Storage System 
IO Procedure for OpenDoc Storage 
Units work. The media object name 
must contain all of the information 
necessary to access the object properly, 
which includes ensuring that the 
MMIO subsystem correctly identifies 
the OpenDoc IO Procedure when ap- 
propriate and that the correct Storage 
Unit, Property, and Value names are 
accessed. The programmer has some 
freedom in determining the syntax of 
the media object names that the 
Storage System IO Procedure will use. 

The MMIO Manager uses a nam- 
ing convention to help expedite the 
identification of the Storage System LO 
Procedure. A dot, followed by the 
FOURCC (Four Character Code) used 
by the IO Procedure and a ‘+’ sign, 
will ensure that the correct IO 
Procedure is used. 

Listing 4 shows the possible syn- 
tax of the media object name that con- 
tains the necessary information. The 
components of the name are delimited 
by ‘+’ signs because they are consistent 
with the legacy compound file naming 
convention but are not required. 

Because the OpenDoc component 
handler is passed an ODStorageUnit +* 
when it is created for storing its data, 
and a storage unit may or may not 
have a valid name, it is necessary to in- 
clude the pointer in the name of the 
media object. It is possible to pass the 


pointer in the form of a string em- 
bedded as a piece of the com- 
pound name. The Property and 
Value names should also be in- 
cluded in the compound name. 
Finally, the appropriate file ex- 
tension for the data should be ap- 
pended to the Value name, so that the 
Media Device Manager (MDM) can 
properly route the open request to the 
appropriate MCI Driver. Combining 
the file extension (normally be used 
for the data) to the Value name and 
stored in the document is preferable. 
If, for example, the data is a .FLI or 
-FLC animation file, which are nor- 
mally silent, the File Format IO Pro- 
cedure in OS/2 looks for a corre- 
sponding .WAV file to use as an 
audio track, If there is another Value 
that has the same name, but with a 
.WAV extension, then it could be used 
for the audio track. 


IMPLEMENTING THE STORAGE 
SYSTEM 10 PROCEDURE 

The MMIO Storage System IO 
Procedure must implement the set of 
commands shown in Table 1, 

Since a pointer embedded in the 
media object name is being passed to 
the IO Procedure, the [O Procedure 
may want to validate it somehow be- 
fore accessing it. The OpenDoc compo- 
nent handler can register valid storage 
units by adding them to a list. When 
an MMIOM_OPEN or an MMIOM_IDENTIFYFILE 
occurs, the IO Procedure can validate 
the pointer as being a_ valid 
ODStorageUnit *. The Storage Unit is re- 
moved from the list when the object is 
no longer accessible. 

MMIOM_BEGINSTREAM and MMIOM_END- 
STREAM are used to indicate when play- 
back or record is occurring. This gives 
the IO Procedure the opportunity to 
request a certain level of service from a 
network. The ODStorageUnit MMIO IO 
Procedure need only return 0. 

The MMIOM_GETFORMATINFO message 





MMIOM_OPEN Open the specified media element 

MMIOM_CLOSE Close the media element 

MMIOM_READ Read a block of data 

MMIOM_WRITE Write a block of data 

MMIOM_SEEK Seek to a specified offset in the data 

MMIOM_IDENTIFYFILE Identify the media element name 

MMIOM_GETFORMATINFO Return information about the 10 Procedure 

MMIOM_GETFORMATNAME Return the name of the IO Procedure 
MIOM_BEGINSTRE Begin streaming the data 

MMIOM_ENDSTREAM End streaming the data 


Table 1. Required MMIO messages for Storage System IO Procedure. 
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provides capability information about 
the storage unit to the MMIO manager. 
The IO Procedure should indicate that 
it is a Storage System IO Procedure 
rather than a File Format IO Procedure. 
It should also indicate that it can 
read/write/seek/readwrite untranslated. 

The MMIOM_GETFORMATNAME message 
simply returns a user-readable name 
for the Storage System IO Procedure, 
however, no applications that I know 
of actually display Storage System IO 
Procedures. 

For MMIOM_IDENTIFYFILE, the IO 
Procedure should validate the format 
of the name and return MMIO_SUCCESS if it 
is valid or MMIO_ERROR if it is not valid. 
At this point, the ODStorageUnit * 
shouldn't be validated against the list, 
but rather during the MMIOM_OPEN pro- 
cessing. If the IO Procedure fails to 
identify a name that is in fact intended 
for the 0DStorageUnit IO Procedure, it 
will then probably be identified by the 
DOS IO Procedure, and the file system 
will surely report an ERROR_INVALID_NAME 
error. 

The [O Procedure will need to 
have an instance data structure that 
contains the open flags, the 0DStorage- 
Unit +, the Property name, and the Val- 
ue name. These instance data struc- 
tures should be linked together into a 
list so that multiple opens of the same 
Property / Value pair can be detected 
and access control emulated (like the 
File System). 


IMPLEMENTING OPEN 

The MMIOM_OPEN processing is the most 
complicated. The errors returned from 
the IO Procedure are important so that 
the use of this IO Procedure is trans- 
parent to existing software. This means 
that OpenDoc ODStorageUnit error con- 
ditions should be translated to MMIO 
errors or OS/2 File System errors. File 
system errors are frequently put into 
the ulErrorRet field of the MMIOINFO 
structure. 

When processing the MMIOM_OPEN 
message, the IO Procedure should val- 
idate the name to ensure that it has all 
of the required pieces of information. 
If it isn’t a valid name, the procedure 
should return MMIOERR_INVALID_FILENAME. 

The procedure should then deter- 
mine if there are any other instances 
being accessed and check the open 
flags of both instances to determine if 
they are compatible. If they are not 
compatible, then return MMIOERR_IN- 
VALTD_ACCESS_FLAG. 

The instance data structure can 
then be initialized. Typically, the 


ULONG EXPENTRY SULOProcOpen( PMMIOINFO pmmioinfo, 
LONG 1Parami, 


LONG 1Param2) 
{ 
ULONG size=0;  // size of property 
ULONG rc; // return code 


PSZ pszFileName // file name 

PSUINFO pSUInfo; // Storage Unit object instance information 
BOOL flock = FALSE; // Storage Unit locking 

Environment * ev = somGetGlobalEnvironment(): 


if ('pmmioinfo) return (MMIO_ERROR); 

pszFileName = (PSZ)1Parami; // get the filename from 
parameter. 

if (!pszFileName) return (MMIQERR_INVALID FILENAME) ; 


// validate name (basically identify the object) 


pSUInfo = ValidateName (pszFileName) ; 
if ('pSUInfo) return (MMIOERR_INVALID_FILENAME) ; 
ReleaseName (pSUInfo) ; 


// Get access to the object 


pSUInfo = AccessName (pszFileName, pmmioinfo->ulFlags) ; 
if (!pSUInfo) return (MMIDERR_INVALID_ACCESS_FLAG) ; 
pmmioinfo->aulInfo[i] = (ULONG) pSUInfo; // save it for later 


// complete the open 
if (pmmioinfo->ulFlags & MMIO_DELETE) { 


pSUInfo->key = pSUInfo->pStorageUnit->Lock (ev, 0); 
if (!IsException(ev)) { 
if (pSUInfo->pStorageUnit->Exists (ev, 
psUInfo->szPropertyName, 
pSUInfo->szValueType, 
0)) f 
pSUInfo->pStorageUnit->Focus(ev, 
psUInfo->szPropertyName, 
kODPosFirstSib, 
pSUInfo->szValueType, 
0, 
kODPosFirstSib) ; 
if ('IsException(ev)) { 
pSUInfo->pStorageUnit->Remove(ev); 
pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
} else { 
pmmioinfo->ulErrorRet = ERROR_FILE_NOT_FOUND; 
pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
ReleaseName (pSUInfo); 
return (ERROR_FILE_NOT_FOUND): 
} 
} else { 
pmmioinfo->ulErrorRet = ERROR_FILE_NOT_FOUND; 
pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
ReleaseName (pSUInfo); 
return (ERROR_FILE_NOT_FOUND); 
} 


} else { 
pmmioinfo->ulErrorRet = ERROR_ACCESS_DENTED; 
pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
ReleaseName (pSUInfo); 
return (ERROR_FILE_NOT_FOUND); 

} 


ReleaseName (pSUInfo); 


pmmioinfo->aulInfo[i] = 0; 
return (0); 


Listing 5 Open processing example. (Continued on page 62.) 





} else if ( pmmioinfo->ulFlags & MMIQ_CREATE ) { 





// Remove the Property / ValueType if there 


if (pSUInfo->pStorageUnit->Exists (ev, 
psUInfo->szPropertyName, 
pSUInfo->szValueType, 
0)) { 
pSUInfo->key = pSUInfo->pStorageUnit->Lock (ev, 0); 
if (!IsException(ev)) { 
pSUInfo->pStorageUnit->Focus(ev, 
psUInfo->szPropertyName, 
kODPosFirstSib, 
psUInfo->szValueType, 
0, 
kODPosFirstSib) ; 
if (!IsException(ev)) { 
pSUInfo->pStorageUnit->Remove (ev); 
} 


} 
pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 


// now create it new property 


pSUInfo->key = pSUInfo->pStorageUnit->Lock (ev, 0); 
if (!IsException(ev)) { 
pSUInfo->pStorageUnit->AddProperty (ev, 
pSUInfo->szPropertyName) ; 
if (!IsException(ev)) { 
pSUInfo->pStorageUnit->AddValue (ev, 
pSUInfo->szValueT ype); 
if ('IsException(ev)) { 
pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
} else { 
psUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
ReleaseName (pSUInfo); 
pmmioinfo->ulErrorRet = ERROR_INVALID_NAME; 
return (ERROR_INVALID_NAME) ; 
} 
} else { 
pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
ReleaseName (pSUInfo); 
pmmioinfo->ulErrorRet = ERROR_INVALID_NAME; 
return (ERROR_INVALID_NAME); 
} 
} else { 
pSUInfo->pStorageUnit->UnLock (ev, pSUInfo->key); 
ReleaseName (pSUInfo); 
pmmioinfo->ulErrorRet = ERROR_INVALID_NAME: 
return (ERROR_INVALID_NAME); 
} 


pmmioinfo->lLogicalFilePos = 0; 
} else { /* standard open +/ 


pSUInfo->key = pSUInfo->pStorageUnit->Lock (ev, 0); 
if ('IsException(ev)) { 
if (pSUInfo->pStorageUnit->Exists (ev, 
pSUInfo->szPropertyName, 
pSUInfo->szValueType, 
0)) f 
pSUInfo->pStoragellnit->Focus(ev, 
pSUInfo->szPropertyName, 
kODPosFirstSib, 
pSUInfo->szValueType, 
0, 
kODPosFirstSib) ; 
if ('IsException(ev)) { 
size = pSUInfo->pStorageUnit->GetSize(ev); 


NOVEMBER/DECEMBER 1995 67 








; eae oe eee (ev, pSUInfo->key); 
pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
ReleaseName (pSUInfo) ; 
pmmioinfo->ulErrorRet = ERROR_FILE_NOT_FOUND; 
return (ERROR_FILE_NOT_FOUND) ; 


is returned in the 
ulErrorRet field if 
something then fails 
here. 

The MMIOM_OPEN 
could also be a stan- 


} dard open, with or 
} else { | without the MMI0_AP- 
pSUInfo->pStorageUnit->UnLock (ev, pSUInfo->key); PEND flag. If the 


ReleaseName (pSUInfo) ; 


pamioinfo->ulErrorRet = ERROR_FILE_NOT_FOUND; 


; return (ERROR_FILE_NOT_FOUND); 
} else { 


pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 


ReleaseName (pSUInfo); 


pmnioinfo->ulErrorRet = ERROR_ACCESS_DENIED; 


, return (ERROR_ACCESS_DENIED) ; 


if (size == 0) { 


// This will cause the audio mcd to call us back 


MMIO_APPEND flag is 
set, the logical file 
position should be 
initialized to the 
length, otherwise to 
0. The length of a 
particular Focus-ed 
Value can be deter- 
mined with the Get- 
Size() method. The 
lLogicalFilePos field 
of the MMIOINFO struc- 


again with a create 

pmmioinfo->ulErrorRet = ERROR_FILE_NOT_FOUND; ture defines the file 

ReleaseNiame (pSUInfo) ; position. 
return (ERROR FILE_NOT_FOUND) ; One anomaly 
occurs during open 
if (pmmioinfo->ulFlags & WMIO_APPEND) { processing: if the IO 
pnnioinfo->lLogicalFilePos = size; Procedure is asked 
} else { // normal open to open a Property / 


panioinfo->LogicalFilePos = 0; 


} 
return (0); 


Listing 5. Open processing example. (Continued from page 61.) 


pointer is stored in the aulInfo[1) field 
of the MMIOINFO structure, which is 
passed to the IO Procedure on each 
subsequent call by the MMIO 


Manager. 
During the processing of MMIOM_OPEN 
the open flags may _ contain, 


MMIO_DELETE, which indicates that the 
Value should be deleted. This is done 
by calling Lock(), Exists(), Focus(), Re- 
move(), and Unlock() on the ODStorageUnit 
object. These are SOM 2.x IDL meth- 
ods, and it is very important to always 
check the Environment for exceptions 
if they occurred, so that they can be 
translated to MMIO Errors and re- 
turned properly. The common errors 
here are ERROR_ACCESS_DENIED or ER- 
ROR_FILE_NOT_FOUND. 

MMIO_CREATE may also be passed as 
an open flag. In this case, a new 
Property/ Value pair should be cre- 
ated by calling Lock; Exists() to deter- 
mine if it already exists; and Focus(), 
AddProperty(), AddValue(), and UnLock(). 
ERROR_INVALID_NAME or ERROR_ACCESS_DENIED 
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Value pair that ex- 
ists but has zero 
length, it should be 
treated as if the 
property doesn’t 
exist. All multime- 
dia files have head- 
ers. If the mmioGet- 
Header() fails, the 
subsystems check 
for Extended Attri- 
butes to determine if the file is a tem- 
plate. Since Extended Attributes are 
not supported by any Storage System 
1O Procedures, the File Format IO 
Procedures directly use file system 
APIs. By treating a zero length 
Property as if it doesn’t exist, the mul- 
timedia File Format IO Procedures will 
create it and initialize it properly. 
Listing 5 shows how the Open 
processing would be implemented. 


BASIC READ/WRITE PROCESSING 

The remaining JO functions are more 
straightforward. MMIOM_READ is pro- 
cessed by calling Lock(), Focus(), 
Set0ffset() to the most recent seek off- 
set, GetValue() to get block of data, and 
Unlock(). 

MMIOM_WRITE is processed by calling 
Lock(), Focus(), Set0ffset() to the most 
recent seek offset, SetValue() to set the 
block of data, and Unlock(). On the 
write, it is important to check the bytes 
actually written, and if it is less than 
the write attempt, return the MMIO0- 
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ERR_CANNOTWRITE error. This indicates 
that the disk is full. 

MMIOM_SEEK just updates the 
lLogicalFilePos field in the MMIOINFO 
structure. This offset will be used on 
the next read, write, or seek operation. 

MMIOM_CLOSE just releases the in- 
stance data structure. 

Because this IO Procedure uses a 
pointer in the media object name, it’s 
probably not a good idea for the appli- 
cation to store these media object 
names persistently anywhere. Also, 
since only your application has knowl- 
edge of this IO Procedures media- 
naming syntax, it’s a good idea to reg- 
ister the IO Procedure only for the 
application’s process and not for the 
whole system. This is easily done by 
using the mmioInstall10Proc() function 
of MMIO. 

With a Storage System IO 
Procedure that makes OpenDoc 
Storage Unit calls, Multimedia data 
can be transparently integrated into 
most any OpenDoc component and 
embedded into any OpenDoc aware 
application. This gives application de- 
velopers much more flexibility and 
more opportunity to combine their 
multimedia-enabled software with 
other software components to yield 
unique solutions. 


ADVANCED TOPICS 

Another topic to consider when de- 
signing a Storage System IO Procedure 
for OpenDoc is whether the storage 
unit needs to be accessed by more than 
one process. For example, drag-and- 
drop or clipboard support in the 
OpenDoc component handler may 
want to avoid copying large amounts 
of data, such as a video or large audio 
annotation, so it might choose to pass 
a file name or media object name 
where the data can be accessed by the 
receiver. This problem would require 
letting the owner process service re- 
quests to access the data by using 
some custom mechanism like PM mes- 
sage passing between processes or 
possibly using Distributed SOM 
(DSOM) to access the object. If multi- 
ple processes are involved, its a good 
idea to include the process ID of the 
process that owns the ODStorageUnit ob- 
ject in the name of the media object. 
Allowing only read access would 
probably be a good idea from another 
process. 

Another issue is undo/redo sup- 
port in the OpenDoc component han- 
dler. Typically, before chaining some 
internal data of a component, the han- 


dler will put the old data into an undo 
stack, so that the modification can be 
undone at a later point in time. If you 
are using the multimedia subsystem to 
directly put data into the storage unit, 
the handler will want to know just be- 
fore the data is written that the data is 
going to be modified, allowing it to 
create an undo record. Large amounts 
of data are a bit problematic for undo, 
however, the O0DStorageUnit IO Pro- 
cedure could provide a callback to the 
component handler when MMIOM_WRITE 
or MMIOM_OPEN with MMID_CREATE is called. 


OTHER WAYS 

Of course, other ways do exist to inte- 
grate multimedia data into OpenDoc 
component handlers. OS/2 provides 
basic multimedia component handlers 
for audio, video, image, and MIDI. 
These handlers provide some of the 
more common functions that a user 
would want to do with sampled audio, 
digitized video, scanned images, or 
computerized music. These compo- 
nent handlers could be embedded into 
a more specialized component pro- 
grammatically as well as by the users, 
giving them a common interface for 
dealing with these data types and free- 
ing up the programming to provide 
more of what they are good at. 


Scott Broussard js an advisory programmer 
in OS/2 multimedia development and is 
responsible for designing and developing mul- 
timedia user interfaces. He is currently the 
lead architect for the OS/2 Multimedia 
Workplace Shell/OpenDoc team. Broussard 
can be reached at Scott_Broussard@bocara- 
ton.ibm.com. 
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e Domain/accounts corrupted? 
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¢ Break-up/consolidate domains? 
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ATF's unique ability to do multi-user 
workflow testing has made ATF the 
testing tool of choice for corporations 
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(or fax 617-864-7747). 
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The staff of OS/2 Developer put together this special section to guide you through the 
various client/server tools. The products in this guide are based on surveys sent to ven- 
dors; they are provided as a service to you and are free to vendors. These listings do not 
represent an endorsement by OS/2 Developer. A/though every effort has been made to 
ensure accuracy, we do not assume responsibility for any errors or omissions. 


Client/Server Tools 
Buyers Guide 


ANDERSEN CONSULTING'’S 
FOUNDATION SOFTWARE 
ORGANIZATION Circle No. 101 
Foundation for Cooperative Processing (FCP) al- 
lows for asynchronous message routing be- 
tween client and server systems. FCP is a 
second-generation client/server solution that 
allows organizations to develop and deploy 
enterprise-wide, mission-critical applica- 
tions. FCP features the Rapid Application 
Builder (RAB), a design approach that eases 
the process for developing client/server sys- 
tems; Foundation Construction, which gen- 
erates cade for client/server applications 
from objects stored in the repository; and 
Foundation Production, which includes pre- 
sentation services, distribution services, and 
applications services. The current release, 
FCP 2.4, provides additional capabilities, 
such as increased ease-of-use through im- 
proved online documentation, tutorials, and 
migration utilities; increased openness 
through user-defined object types, and a 
published information model. New produc- 
tivity features, such as window control and 
WYSIWYG enhancements; extended archi- 
tecture for ultrahigh performance (NT clients 
and an HP-UX gateway to CICS); and new 
support for OS/2 32-bit, SUN Solaris for 
SPARC (server), DEC OSF/1 for Alpha AXP 
(server), and IBM AIX for RS/6000 (server) 
are also included 

Andersen Consulting’s Foundation 
Software Organization, 69 W. Washington, 
Chicago, III. 60602 (312) 507-3322, fax (312) 
507-0594. 


ASPECT COMPUTING PTY LTD. Circle No.102 
LANSA/CS400 develops multilingual cli- 
ent/server applications using a single, easy- 
to-learn skill set. Its comprehensive OS/2 de- 
velopment environment includes compile, 
test, debug, and task-tracking facilities. A 


centralized LANSA repository holds busi- 
ness rules, triggers, and stored procedures 
and ensures data integrity is maintained. 
Finished applications have access to data res- 
ident on DB2/400, DB2/2 databases, or via 
ODBC and DRDA interfaces. 

Aspect Computing Pty Ltd., Level 11, 122 
Arthur St., North Sydney, NSW, Australia, 
2060, 61-2-9957-3188, fax 61-2-9957-2657. 


BRIGHTWARE Circle No. 103 
ART*Enterprise is a client/server application 
development tool that offers rules, case- 
based retrieval, and advanced object-ori- 
ented programming capabilities for building 
intelligent applications. 

Brightware, 101 Rowland Wy., Ste. 310, 
Novato, Calif. 94945, (415) 899-9070, fax (415) 
899-9080. 


CGI SYSTEMS INC. Circle No. 104 
PACBASE/CS, is an integrated application de- 
velopment tool that includes support for 
client/server development and legacy sys- 
tems. With an interactive multiuser reposi- 
tory driving the process, PACBASE/CS can 
generate complete applications for over 45 
target environments, including IBM main- 
frames (MVS/VSE), midrange (S/38, AS/ 
400, RS6000), and PCs (OS/2, MS-DOS, 
UNIX). IBM has selected CGI’s PAC- 
BASE/CS family of products as its premier I- 
CASE solution. CGI's integrated application 
development products operate on main- 
frames, LANs, and UNIX machines. 

CGI Systems, Inc, 1 Blue Hill Plaza, 
Pearl River, N.Y. 10965, (914) 735-5030, fax 
(914) 735-2231. 


CIMTECH Circle No.105 
CIMVIEW is designed for technical manage- 
ment and supervision applications. Based on 
a distributed real-time and archives database, 


OS/2 DEVELOPER 


it gathers information from all processing 
equipment (PLCs, DCS, measurement, and 
so on). In this way, CIMVIEW allows instal- 
lation managers to completely manage their 
entire application, either for the daily follow- 
up and control, or for long-term manage- 
ment such as modeling and quality control. 

Cimtech, 20 Rue de L'Industrie, 
Nivelles, Belgium 1400, 32-067-883666, fax 
32-067-883688. 


CLIENT/SERVER LABS Circle No. 106 
Reference Performance Mark Benchmark 
(RPMark) is based on industry standard 
workloads. The RPMark benchmark is a 
comprehensive performance evaluation de- 
signed specifically for client/server environ- 
ments. It is made up of three workloads run- 
ning concurrently. The components include: 
Online Transaction Processing (OLTP), 
which uses client/server transaction-ori- 
ented applications, is based on a subset of 
the TPC-IP benchmark, and is modified to 
run in a true client/server environment; 
Decision Support, which PC clients use to 
initiate query-intensive applications on the 
server using Open Database Connectivity 
(ODBC) calls; and File-Serving/ Office 
Automation Services, based on a subset of 
the Business Application Performance Corp. 
(BAPCo) benchmark, for personal productiv- 
ity applications. The RPMark designation 
will be given to client/server components 
undergoing the performance evaluation. 

Client/Server Labs, 8601 Dunwoody PL, 
Ste. 332, Atlanta, Ga. 30350-2509, (770) 552- 
3645, fax (770) 993-4667. 


COMPUWARE CORP. Circle No . 107 
Uniface 6.0 uses a model drama approach to 
enable developers to build enterprise 
client/server applications scalability and 
portability. Uniface 6.0 is based on four prin- 
ciples: model-driven development for high 
productivity and portability, graphical ob- 
ject-based environment for visual and easy- 
to-use applications, technology-independent 
deployment for scalability and flexibility, 
and team development for group productiv- 
ity. Uniface 6.0 is a native OS/2 develop- 
ment system that supports all platforms, op- 
erating systems, GUIs and character mode, 
data sources, networks, and CASE tools. 
Uniface 6.0 supports DB2/2, DB2/6000, 
DDCS, IBM Lan services, and Workplace 
Shell. 

Compuware Corp., 31440 Northwestern 





Hwy, Michigan, Ill. 48334-2546, (810) 737- 
7119, fax (810) 737-7108. 


ERGIE S.A. Circle No. 108 
TP Tools/2 is an engine that uses services 
modules for client/server, teleprocessing, 
and general purposes such as PM screen dy- 
namic and static management, printing mod- 
els, data access, and communications. Its 
method is based on rules interpretation, 
which can be handled by customers, regard- 
less of their development knowledge. 

ERGIE S.A., 1 rue Nicolas Copernic, 
Arles, 13200. 


GATEWAY SYSTEMS CORP. Circle No.109 
Synergist is a cooperative processing cli- 
ent/server development tool that integrates 
PCs with host computers. It is used to de- 
velop online, transactional-based applica- 
tions. All applications execute on the PC, ac- 
cessing a host and/or PC database. Major 
modules include Dictionary, Forms Gen- 
erator, and Forms Compiler. Features in- 
clude pop-up windows, lists, tables, condi- 
tional displays, and redefinable function 
keys. 

Gateway Systems Corp., 4660 5S. 
Hagadorn, Ste. 110, East Lansing, Mich. 
48823, (517) 337-8960, fax( 517) 337-2868. 


GLOBAL VILLAGE 
COMMUNICATION Circle No. 110 
FaxWorks API Toolkit provides client/server 
fax services to applications on OS/2. 
Applications that you write using API will 
work with all fax hardware that is supported 
by the FaxWorks OS/2 products. The API 
supports both spooled and current call send- 
ing and receiving, status monitoring, format 
conversion, custom dialing, and LAN rout- 
ing and notification. This product includes 
the Fax Printer Driver Toolkit. 

Global Village Communication, 1110 
Northchase Pkwy, Ste. 150, Marietta, Ga. 
30067, (404) 984-8088, fax ( 404)984-9956. 


GREAT LAKES SOFTWARE Circle No. 111 
GLS-Presto is an integrated development en- 
vironment that lets developers visually cre- 
ate client/server and stand-alone applica- 
tions, which are executable under both OS/2 
and Windows. Presto supports application 
development in Cobol, C, and C++. 

Great Lakes Software, 810 East 
Coliseum Blvd., Ste. 109, Fort Wayne, Ind. 
46805, (219) 481-5809, fax (219) 455-3275. 
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HOCKWARE Circle No. 112 
VisPro/Reports 1.0 is a REXX-enabled re- 
port writer for VisPro/REXX, VX 
REXX, and OS/2 REXX. It allows you 
to print reports including invoices, 
form letters, personnel reports, and fi- 
nancial reports. A variety of Avery™ 
labels are supported, allowing the user 
to print addresses and other labels. A 
CUA’91 style WYSIWYG report de- 
signer allows the user to include busi- 
ness graphics, photographs, calculated 
fields, multiline text, and other cos- 
metic shapes. Apply numerous object 
attributes, including 16 million colors, 
OS/2 ATM fonts, fill patterns, and 
drop shadows. 

HockWare, 315 North Academy 
St., Ste. 100, Cary, N.C. 27513, (919) 
380-0616, fax (919) 380-0757. 


IBM CORP. Circle No. 113 
Paperless Manufacturing Workplace, an 
OS/2 client/server application, lets 
you create, maintain, distribute, and 
display work instructions and associ- 
ated work orders. Multimedia work 
instructions are organized so a user 
views pages of information, displaying 
the items needed to do the job at hand 
using media best suited for the task. 

PlantWorks is a distributed cli- 
ent/server application development 
and processing tool for supervisory 
control and data acquisition (SCADA). 
It uses the OS/2 Presentation Manager 
interface and conforms to SAA stan- 
dards. PlantWorks products use the fa- 
cilities and functions of the Distributed 
Automation Editions systems enabler 
to provide access to the communica- 
tions and device resources. 

IBM Corp., 1000 51st St., Boca 
Raton, Fla. 33431, (407) 443-9019, fax 
(407) 443-6824. 


IBM CORP. Circle No. 114 
VisualGen Developer provides the defin- 
ition and test of complete applications 
for client/server, including OS/2 and 
Windows GUI clients and local and re- 
mote servers. VisualGen is a visual 
programming solution for developing 
client/server applications. The prod- 
uct includes visual construction of GUI 
client applications and a robust 4GL 
for building remote and server appli- 
cations. Clients are supported on OS/2 
and Windows. VisualGen exploits the 
DB2 and CICS families for data inte- 
gration and high-volume transaction 
processing. 

IBM Corp., Software Solutions 
Division, 11000 Regency Pkwy., Bldg. 
671/3ba, Cary, N.C. 27511, (919) 469- 
6329, fax (919) 469-4410. 


INTERSOLV INC. Circle No. 115 
APS/PC for OS/2 enables rapid develop- 
ment of client/server and traditional 
production applications for OS/2 with 
Oracle, MicroSoft/Sybase SQL Server, 
DB2/2, DB2, DB2/6000, SQL/400, 
IMS/DM, VSAM, and OS/400 native 
data file sources. Client/server appli- 
cations are generated using database 
servers, gateways, or APPC-connected 
server programs—100% generated by 
APS. APS provides an open, extensi- 
ble, and customizable development 
environment with no proprietary lan- 
guage or runtime components. APS of- 
fers a solution for both new develop- 
ment and existing-system enhance- 
ment, for both client/server and tradi- 
tional systems, across many produc- 
tion platforms. 

Intersolv Inc., 1700 N.W. 167th PL, 
Beaverton, Ore. 97006, (800) 547-4000, 
fax (301) 838-5064. 


ISA INFORMATIONS- 
SYSTEME GMBH Circle No. 116 
ISA Dialog Manager User Interface 
Management System supports all 
major window systems and alphanu- 
meric terminals. A client/server com- 
ponent allows the distribution of ap- 
plication and dialog in heterogeneous 
environments. 

ISA Informationssysteme GmbH, 
Azenbergstrasse, 35 Stuttgart, D-70174, 
49-711-227690, fax 49-711-22769-19. 


INTELLIGENT 
ENVIRONMENTS INC Circle No. 117 
AM/Harvest is a project manager and 
documentation tool that reduces the 
cost of large-scale client/server appli- 
cation development projects. It offers 
teams of programmers the capabilities 
for change-management and “where- 
used” impact analysis—streamlining 
application design, construction, and 
modification. AM/ Harvest reads and 
analyzes program listings, stores the 
information in a repository, and auto- 
matically documents the application. It 
enables previously developed code to 
be “harvested” for better maintenance 
and for reuse in new applications. 
AM/Harvest generates complete on- 
line system documentation in easy-to- 
use hypertext format (OS/2.INF files). 
All references to variables, procedures, 
functions, and modules are hot-linked 
to details on the usage of each entity. 
AM/Solo uses a highly visual, in- 
teractive interface to let developers 
produce client/server applications. 
AM/Solo is designed to be used by 
conventional as well as specialist pro- 
grammers. Its aim is to hide the com- 
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plexity of graphical user interfaces, 
multitasking, and object orientation 
but deliver their power. 

Intelligent Environments Inc., 2 
Highwood Dr., Tewksbury, Mass. 
01876, (617) 272-9700. 


KALEIDA LABS INC. Circle No. 118 
ScriptX Language Kit (SLK) 1.0 provides 
technically sophisticated and experi- 
enced multimedia content and tool de- 
velopers early access to the power and 
flexibility of the ScriptX Language and 
Class Library. The language is fully 
object-oriented, multithreaded, device 
independent, C-extensible, and incre- 
mentally compiled. The product also 
features multiple inheritance, dynamic 
binding, and built-in data searching. 
Class Library features include: clocks 
and players, two-dimensional graphics 
and text; model-presenter-controller, 
data management, and user interface 
or interaction. 

Kaleida Labs Inc., 1055-B Joaquin 
Rd., Mountain View, Calif. 94043, (415) 
335-2098, fax (415) 335-2097. 


KASE SYSTEMS INC. Circle No. 119 
KASE: VIP for 0S/2 is a knowledge-as- 
sisted visual design and code-genera- 
tion tool for building GUI and 
client/server applications. Use the vi- 
sual designers to create OS/2 objects 
and then associate them with business 
logic and data. In a client/server envi- 
ronment, this process produces a 
seamless integration with SQL data- 
bases or CICS transactions. KASE: VIP 
then generates the application source 
code in C. 

KASE:VIP is a visual design and 
standard language code-generation 
tool for developing business-critical 
client/server applications for OS/2. 

KASE Systems Inc., 1 Meca Wy., 
Ste. 150, Norcross, Ga. 30093, (404) 
564-5696, fax (404) 564-5679. 


LANWORKS 

TECHNOLOGIES INC. Circle No. 120 
BootWare Manager is a fully integrated 
Windows-based NetWare LAN man- 
agement console. It works with 
BootWare or BootWarePLUS to pro- 
vide centralized boot management so- 
lutions. Administrators can create, 
maintain, and update boot image files 
on the server for PCs. BootWare 
Manager also provides image and 
global diagnostics with flexible sorting 
and reporting functions. 

Lanworks Technologies Inc., 2425 
Skymark Ave., Mississaugia, Ont. 
L4W 4Y6, Canada (905) 238-5528, fax 
(905) 238-9407, 


MOZART SYSTEMS CORP. Circle No. 121 
Mozart, a graphical user interface and 
software development tool, helps busi- 
nesses realize immediate client/server 
benefits from legacy applications. 
Applications may be developed and 
run without recompilation or modifi- 
cation. Use Mozart to renovate legacy 
applications to achieve client/server 
benefits quickly. 

Mozart Systems Corp., 1350 
Bayshore Hwy, Ste. 630 , Burlingame, 
Calif. 94010, (415) 340-1588, fax (415) 
340-1648. 


NETRON INC. Circle No.122 
Netron Fusion is a systems delivery so- 
lution for building large-scale applica- 
tions for mainframe, midrange, and 
client/server environments. Combined 
with an integrated toolset, Netron 
Fusion uses a component approach to 
software reuse that has been proven to 
produce core systems 70% faster than 
the industry average. It features an 
open, scalable architecture for maxi- 
mum flexibility and complete control 
over the development process. It also 
offers template programs for prototyp- 
ing, consisting of program specifica- 
tions, class libraries, screens, and sam- 
ple files that developers can use 
immediately. 

Netron Inc., 99 St. Regis Cres. N., 
Toronto, Ont. M3] 1Y9, Canada (416) 


636-8333, fax (416) 636-4847, 
OPEN SOFTWARE 
ASSOCIATES INC. Circle No. 123 


OpenU! provides a way to develop user 
interfaces for client/server and stand- 
alone applications. It drives the same 
interface on all character terminals 
using a standard GUI, without addi- 
tional development. A user interface 
developed on one GUI/platform can 
be migrated without redevelopment to 
any other GUI/platform, maintaining 
the native look and feel. 

Open Software Associates Inc., 20 
Trafalgar Sq., Ste. 414, Nashua, N.H. 
03063, (603) 866-4330, fax (603) 598- 
6877. 


PARCPLACE 

SYSTEMS INC. Circle No. 124 
Visual Works is a client/server tool for 
building portable applications using 
object-oriented technology. A Data- 
base Applications Creator is included 
for rapid application development. 
Applications developed are instantly 
portable across multiple platforms, are 
scalable across the enterprise, and can 
have their functionality distributed be- 
tween both client and servers. 


ParcPlace Systems Inc., 999 East 
Arques Ave., Sunnyvale, Calif. 94086- 
4593, (408) 481-9090, fax( 408) 481- 
0214. 


PROTOSOFT Circle No. 125 
Paradigm Plus 3.0 is an application de- 
velopment tool that supports 


Enterprise Component Modeling 
(ECM), code generation, and reverse 
engineering. Using ECM, companies 
can identify business requirements, 
model reusable application compo- 
nents, and manage systems over the 
long term. Paradigm Plus makes ECM 
possible through its support for lead- 
ing object-oriented methodologies; in- 
corporation of an object repository for 
teams of concurrent users; and auto- 
matic synchronization of models, 
source code, and documentation. 
Using methods such as OMT, Fusion, 
Martin /Odell OOIE, and others ex- 
tended to support Jacobson’s Use Case 
modeling, Paradigm Plus automates 
all leading object-oriented methods in 
a single solution. Automatic genera- 
tion of C, C++, Smalltalk, Ada, and 
ODBMS and RDBMS schema defini- 
tions increases productivity. Built-in 
consistency checks ensure quality and 
reduce maintenance costs, while a 
script language allows custom report- 
ing, checking, and code generation. 
Reverse engineering utilities preserve 
your investment in legacy software. 
Online hypertext help, thorough docu- 
mentation, and hands-on tool training 
give your team a quick start. Paradigm 
Plus is available on most popular 
UNIX and PC platforms. 

ProtoSoft, 17629 El Camino Real, 
Mail Stop 400, Houston, Tex. 77058, 
(713) 480-3233, fax (713) 480-6606. 


SYBASE INC. Circle No. 126 
Open Server™ 10.0 is a programmable, 
network-independent server for creat- 
ing high-performance client/server 
applications. It allows client applica- 
tions to access diverse data, including 
flat files, real-time data, e-mail, and re- 
lational data. 

Sybase Inc., 6475 Christie Ave., 
Emeryville, Calif. 94608, (510) 922- 
8547, fax (510) 922-4747. 


SYNON INC. Circle No .127 
Synon Client/Server Generator for 0S/2 
enables application developers to re- 
generate Synon/2E design models to 
run on OS/2 and Windows 3.1 plat- 
forms. Synon/CSG delivers distrib- 
uted function C/S applications with 
client processing in Microfocus 


COBOL /2, OS/2 help native commu- 
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nication handling while the AS/400 
server stores DB2/400 database. 

Synon Inc., 1100 Larkspur 
Landing Crle., Larkspur, Calif. 94939, 
(415) 461-5000, fax (415) 461-2171. 


TECHBRIDGE 

TECHNOLOGY Circle No. 128 
TechBridge Builder for OS/2, a visual de- 
velopment tool, simplifies creating ob- 
ject-oriented client/server applications 
through reuse of legacy resources. 
Developers can paint any GUI, includ- 
ing drag-and-drop, in a visual manner 
with no coding. TechBridge Builder 
also offers a COBOL-based scripting 
language for procedural code attached 
to GUI events. Developers need not 
know Smalltalk, C++, or SQL. 

TechBridge Visual Objects is a 
client/server application development 
tool that simplifies the creation of ob- 
ject-oriented applications. Powerful vi- 
sual designers can paint any type of 
GUI, including a drag-and-drop 
OOUI, with point-and-click connection 
to SOL and xbase databases. Little or 
no coding is required. Also supported 
are: a C-based scripting language with 
a source debugger and incremental 
compiler for iterative Rapid App- 
lication Development; team support 
via PVCS interface. 

TechBridge Technology, 5001 
Yonge St., Ste. 1301, North York, Ont. 
M2N 6P6, Canada (416) 222-8998, fax 
(416) 222-0168. 


VMARK SOFTWARE INC. Circle No. 129 
ENFIN Object Studio is a family of ob- 
ject-oriented products for developing 
client/server applications based on 
business objects. These applications 
are scalable, maintainable, and adapt- 
able to changing processes. ENFIN 
provides a suite of visual tools for de- 
veloping and deploying Windows and 
OS/2 applications. It supports a vari- 
ety of architectures with a range of 
connectivity options. 

ESL Continuity is an integrated, 
event-driven, 4GL-based visual tool 
for developing robust production 
client/server applications for Win- 
dows and OS /2. It translates external 
source format code from any CASE 
vendor supporting ESF, including 
IBM, Texas Instruments, Knowledge- 
Ware, and Bachman, into ESL lan- 
guage source code. 

ESL Workbench is an integrated de- 
velopment environment for rapidly 
creating robust production client) 
server applications. The application’s 
visual tools for design, debugging, and 
testing are all grounded in the event- 
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driven ESL development language. 
Also included is ESL DB/ Assist, a 
graphical point-and-click tool for gen- 
erating the SQL portion of your 
client/server application. 

Synchronicity Object Studio is a 
family of object-oriented products for 
developing client/server applications 
based on business objects. These ap- 
plications are scalable, maintainable, 
and rapidly adaptable to changing 
business processes. Synchronicity inte- 
erates the design, assembly, and reuse 
of high-level business objects, ensur- 
ing that the company’s business, the 
system design, and the application al- 
ways remain synchronized. Synch- 
ronicity is bidirectionally integrated 
with ENFIN. 

TeamBuilder Object Studio is a fam- 
ily of object-oriented products for de- 
veloping client/server applications 
based on business objects. These appli- 
cations are scalable, maintainable and 
rapidly adaptable to changing busi- 
ness processes. TeamBuilder enables a 
development team to jointly build ob- 
ject-oriented client/server applica- 
tions. Developers can reuse and build 
upon each other's objects. 

VMARK Software Inc., 50 
Washington St., Westboro, Mass. 


es mic ation Design Teh 
* Amo ing Object 


01581, (508) 366-3888, fax (508) 366- 
3669. 


WATCOM Circle No. 130 
VX*REXX Client/Server Edition is a visual 
development environment for creating 
OS/2 GUI applications. It includes 
powerful connection, query, and chart 
objects that access, build, and connect 
databases, manipulate data, and chart 
the results quickly and easily. 

Watcom, 415 Phillip St., Waterloo, 
Ont. N2L 3X2, Canada, (519) 886-3700, 
fax (519) 747-4971. 


XVT SOFTWARE INC. Circle No. 131 
XVT Development Solution for C++ 
(DSC++) is a true application frame- 
work with powerful features such as 
field validation, drag and drop, envi- 
ronment inheritance, nested views, 
geometry management, imaging, and 
the completely integrated rogue wave 
data structures, Its visual application 
builder is used for the entire applica- 
tion development life cycle, from de- 
sign to layout through final application 
building. DSC++ offers complete 
portability to all popular GUIs. 

XVT Software Inc., 4900 Pearl East 
Crle., Boulder, Colo, 80301, (303) 545- 
3150, fax (303) 443-0969. 





Y.A.M, COMPUTERS 
(1982) LTD. Circle No. 132 
OpenWin is an open client/server, 4GL 
GUI, multiple database, and multiplat- 
form front-end development tool, 
which applies a distributed applica- 
tions client/server paradigm. Open- 
Win is targeted to help developers de- 
sign front-end user interface com- 
ponents such as screens, windows, 
flow-control, and field edits. It inter- 
faces GUIs such as OS/?2, Windows, 
and others, while adapting the best of 
each. OpenWin enables portability of 
applications across platforms by using 
local and global dictionaries on LAN 
servers of differing platforms to simul- 
taneously interface a wide range of 
DBMS and RDBMS products. Open- 
Win has an any-to-any client/server 
ability, with memory and resource 
sharing, enabling real cooperative pro- 
cessing. Its applications can be used as 
clients, servers, or both. Using a 
client/server paradigm to access data- 
base engines and user-defined servers, 
OpenWin is an easy-to-use tool that fa- 
cilitates modular growth and reduced 
costs. 

Y.A.M. Computers (1982) Ltd., 2 
Hadar St., Herzeliya 46290, Israel, 972- 
9-589714, fax 972-9-507317. 
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JBA Guidelines. 
The Application Generator for people who use C++ 
AND those who don’t want to. 


Database Connectivity 
Access to simultaneous, mul- 
tiple databases is transparent 
through JOT. Supported data- 
bases include: DB2, DB2/2, 
DB2/400, DB2/6000, Oracle, 
Lotus Notes Server, and 20 
more through native ODBC. 


























Graphical User Interface 





An intuitive and natural inter- 
face for the direct manipulation 
of on-screen design for OS/2 
and Windows, with over 30) 
powerful controls for the pro- 
fessional developer. Includes all 
the standard controls plus 
Gauge, Button Bar, Grid and 
Graph. 


Logic, Language, and Compiler 
A platform-independent high- = 
level language, JOT combines 
the RAD features of a 4GL 
with the generation of native 
code (C++ and RPG) for the 
Client AND Server, Existing 
legacy 3GL code can be 
directly interfaced. And 
CORBA-compliant objects can 
replace logic at any time in the 
future. 


The Repository 


Network Connectivity 













The 
Guidelines 
Model 





The repository supports and 
surrounds the entire program- 
ming environment with the 
facilities for teamwork develop- 
ment. Databases can be created 
on multiple hosts from a single 
definition. Data definitions can 
be directly imported into a GUI 
program. 


By mixing the connectivity com- 
ponents as required, applications 
can be built as thin clients, thick 
client/server with application 
partitioning, and fully distributed 
Object-Oriented. Supported hosts 
are: OS/2, AS/400, UNIX, MVS. 


Constructed on a six-segment development model, 
JBA Guidelines has been built to answer the needs of 
developers who wish to produce software capable of 
addressing heterogeneous computer networks from 
one single development point. 


Object Messaging 
The Message layer is fully 

compatible with all current 

Object Request Broker (ORB) 

standards. JOT verbs provide a 
single interface to current 
technology and the OO of 
tomorrow. Guidelines provides 
CORBA IDL and IBM SOM 
support. 


Guidelines is available in option packs to serve the 
needs of single PC developers right up to enterprise- 
wide development teams. 


Call for an evaluation CD-ROM. 





JBA International 
1-800-JBA-INTL 
In Europe: (44) 1789-400212 
All trademarks are the property of their respective owners. Internet: http:/ / WW W.] ba.co.uk 
aaa Compuserve: Go Guidelines 
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The staff of OS/2 Developer has put together this special section to guide you through 


_ the new products. These listings do not represent an endorsement by OS/2 Developer. 
Although every effort has been made to ensure accuracy, we do not assume any respon- 


sibility for error in this section. Contact vendor for availability. 


CThrough++. Developed to support the 
building applications in the C/C++ environ- 
ment. Instead of working with files, 
CThrough++ can browse and edit classes and 
their components-—data and functions mem- 
bers. The product stores all information in 
plain ASCII files and uses an editor to handle 
them. CThrough++ integrates tools to graphi- 
cally browse, display, and manage class hier- 
archies; edits classes in a logical way; creates 
applications or modules automatically with- 
out the need for user-generated files; archives 
classes and manages different versions; and 
compares different classes or various ver- 
sions of one class. 


BISS Circle No. 135 
Phone: 44-23-92-89-0, Fax: 44-23-92-89-99 


Fortran 77 10.5. This enhanced version of 
Watcom’s Fortran 77 development system 
includes improved productivity with a 
graphical IDE designed for the development 
of both character-mode and GUI application 
on a variety of platforms. This product fea- 
tures the advantages of a 32-bit performance, 
an advanced GUI debugger, text editor, and 
profiler. Developers can standardize on a sin- 
gle host environment and toolset for multi- 
platform development. 


Watcom Circle No. 136 
Phone: (519) 883-6308 


The Graham Utilities 1.04 for OS/2. Version 
1.04 now includes a systems diagnostics 
package for OS/2 systems. This product adds 
six programs and modules to the already 
strong suite of over 50 applications. The new 
utilities add two more HPFS specific pro- 
grams, two disaster recovery assistance pro- 
grams, a systems diagnostics package, and a 
new disk editor module, which allows HPFS 


New Products for OS/2 


disks to be edited in their native format. All 
of the base HPFS disk structures are able to 
be edited. The diagnostics program allows 
testing and reporting on individual aspects of 
your computer system including, system 
configuration, parallel and serial port test 
and configuration, video test including text 
and graphics test, floppy disk tests, and hard 
disk and keyboard tests. 


WarpSpeed Computers Circle No. 137 
Phone: 61-3-9384-1060, Fax: 61-3-9386-9979 


KopyKat. KopyKat is a remote-control solu- 
tion for OS/2. It provides graphical remote 
control between OS/2 1.3, 2.X, or Warp PCs 
on LANs with NetBIOS. This product sup- 
ports hardware handshaking so developers 
can use high-speed modems at their full 
capacity. In addition, it can display every- 
thing that is displayed on an OS/2 desktop 
including full-screen DOS and full-screen 
Win/OS/2 sessions. There are no “don’t 
touch” keys. 


Hilgraeve Circle No. 138 
Phone: (800) 826-2760, Fax: (313) 243-0645 


IPF Builder. This authoring system allows 
users to create OS/2 INF or HLP files. These 
files are created by writing “source code” 
files that are then compiled by IBM’s IPFC 
compiler into either OS/2 viewable INF files 
or online HLP files. These source code files 
are called IPF files. 


Custom Design Software Circle No. 139 
Phone: (604) 334-2263, Fax: (604) 334-3125 


IND$file for CICS. This product includes an 
audit trail for improved security and data 
compression for better performance. It runs 
above the 16-MB line, transfers MVS data sets 
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directly to the workstation, and supports cus- 
tomer-written IND$file exits. 


Applied Software Inc. Circle No. 140 
Phone: (215) 348-3500, Fax: (215) 348-3535 


Interactive System Productivity Facility 4.2 
(ISPF). ISPF is a family of licensed pro- 
grams for the Multiple Virtual Systems 
(MVS) environment and includes the ability 
to automatically give existing host applica- 
tions a GUI without changing, compiling, or 
distributing any application code or host 
screens. Version 4.2 offers client/server 
technology by providing users and pro- 
grammers with more functions and flexibil- 
ity for creating high-productivity user inter- 
faces for their applications. In addition, 
ISPF provides developers with more plat- 
forms and communication products from 
which to access applications. GUI elements, 
such as group boxes, radio buttons, and 
drop-down list boxes are included. 


IBM Circle No. 141 
Phone: (800) 426-2279 


Juglar 1.3. This OS/2 test management and 
defect-tracking tool provides workflow capa- 
bilities coupled with reporting facilities to 
ensure effectiveness for QA managers. Jugalr 
13 lets developers produce a structured test 
plan and produce accurate management 
information on defect status and activity. In 
addition, this product reduces the time spent 
on testing and bug fixing. 


Systems FX Circle No. 142 
Phone: 44-1844-275175, Fax: 44-1844-343615 


LeadTools DLL for OS/2. Offering an imag- 
ing solution for compression, file format sup- 
port, conversion, and image processing, 
LeadTools DLL for OS/2 contains color, 
grayscale, and bitonal technology. CMP, 
Lead’s bitmap format, features enhanced 
image-processing features, smaller file size, 
and faster decompression. This dynamic link 
library supports OS/2 2.1 and OS/2 Warp 
and can be used to enhance applications 
such as image databases, printing and draw- 
ing programs, video production systems, 
FAX systems, and systems for transmitting 
high-quality images using phone lines and 
networks. LeadTools lets the user convert to 
and from a variety of image file formats 


including OS/2’s native BMP formats, copy 
and paste with the clipboard, and print. 


Lead Technologies Inc. Circle No. 143 
Phone: (704) 332-5532, Fax: (704) 372-8161 


OS/2 Warp Developer’s Package for 
Pentium. This package includes NDP 
Fortran, NDP Fortran 90, NDP Pascal, and 
NDP C/++. In addition, this product works 
with the IBM Workframe. NDP Fortran is a 
full Fortran 77 with BSD 4.2 and DOD exten- 
sions. It is 99% VAX/VMS compatible. NDP 
C/C++ is a full AT&T 2.1 compliant compiler 
that provides optimizations for numeric- 
intensive application, and NDP Pascal is an 
ANSI/TEEE compliant Pascal that also passes 
BSI Level 0 and can access most of the NDP C 
run-time functions. 


MicroWay Circle No. 144 
Phone: (508)746-7341, Fax: (508) 746-4678 


ObjectCatalog. A distributed, cross-platform 
component reuse facility, ObjectCatalog 
enables different development teams to share 
information about software, design patterns, 
frameworks, documents, and other corporate 
assets. ObjectCatalog allows the user to fill 
out questionnaires and define search patterns 
for finding target entries in local and remote 
catalogs. Matching entries are then presented 
graphically according to their degree of simi- 
larity to the request. 


ObjectSpace Inc. Circle No. 145 
Phone: (214) 934-2496, Fax: (214) 663-3959 


ObjectPM Control Pack Library for OS/2. 
This package offers over a dozen control 
types that extend the set of controls supplied 
by OS/2 Presentation Manager. It also sup- 
ports the PMCX control window specifica- 
tion, allowing these controls to be used with 
products such as the IBM Universal Resource 
Editor and Prominare Designer. The PMCX 
specification is the latest control extension, 
similar in concept to the VBX specification in 
Windows. Included in this package are a 
spreadsheet, cellbox, data field, RTF viewer, 
calendars, and splitbars. All controls in 
ObjectPM Control Pack conform to the 
PMCX architecture, allowing the components 
to be used by any OS/2 programming tool. 
Secant Technologies Inc. Circle No. 146 
Phone: (216) 595-3830, Fax: (216) 292-2546 
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Paradigm Plus 3.0. This object-ori- 
ented development tool supports the 
entire software development lifecycle. 
Its graphical environment automates 
leading object-oriented methodologies 
and notations, including OMT, Booch, 
Fusion, Martin/Odell, Caod/ Yourdon, 
and Shlaer/Mellor, while also allow- 
ing the developer to customize meth- 
ods based on business requirements. 
Paradigm Plus generates code in C, 
C++, Ada, and Smalltalk, as well as 
RDBMS and ODBMS schema defini- 
tions. Utilizing an advanced object 
repository and open architecture, the 
product optimizes reuse by allowing 
access to all stored objects and rela- 
tionships in a multiuser environment. 
Unlike other object-oriented tools cur- 
rently available on the market, 
Paradigm Plus facilitates reverse engi- 
neering of existing development 
efforts. 


ProtoSoft Inc. Circle No. 147 
Phone: (713) 480-3233, Fax: (713) 480- 
6606 


PartitionMagic. This product will let 
developers visually modify a hard 
disk on screen as well as shrink, 
expand, move, and convert partitions 
without destroying data. Partition- 
Magic automatically converts a FAT 
file system to HPFS, creates room for 
Boot Manager either before or after 
OS/? is installed, and combines 
unused portions of several partitions 
into a larger block. 


PowerQuest Corp. Circle No. 148 
Phone: (800) 379-2566, Fax: (801) 226- 
8941 


RhinoCom 1.5. RhinoCom’s Work- 
place Shell interface replaces the dial- 
ing directory with an intuitively 
object-oriented phone book, or 
Rhinodex. This product includes 
extensive configurability with logical 
defaults, full-featured macros, fast 
transfers, and REXX scripting. 
Enhanced features include, automated 
script learning with AutoLogon, 
graphical manipulations of global set- 
tings, host mode as a secure back- 
ground BBS, and the CompuServe B+ 
transfer protocol. 


Rhintek Inc. Circle No. 149 
Phone: (410) 730-2575, Fax: (410) 730- 
5960 


Velocis 1.3.1. This product offers soft- 
ware developers access to tools for cre- 
ating high-performance client/server 
applications. New features include 
transaction-processing performance 
improvements, robust dynamic control 
over low-disk space conditions, im- 
proved server configuration capabili- 
ties, and additional administration API 
functions. Use of the server extensions 
allows three-tier architecture, which 
can reduce network traffic and take 
advantage of server power by parti- 
tioning application logic between client 
and server. This product also supports 
server extensions created in C++. 


Raima Corp. Circle No. 150 
Phone: (206) 557-0200, Fax: (206) 557- 
5200 


Show N Tel 3.0. This object-oriented 
development environment for building 
and implementing telephony systems 
enables interactive voice, fax, call pro- 
cessing, speech recognition, call center, 
and multimedia messaging applica- 
tions. This release adds a range of new 
functions for corporate developers, sys- 
tem integrators, and OEMs, including 
over 100 PowerBlocks-graphical pro- 
gram design objects representing high- 
level application functions. Show N Tel 
includes a palette of over 300 
PowerBlocks, with new objects for 
tighter PBX and switch control, in-chas- 
sis switching, and text-to-speech, mes- 
saging, and interactive fax functions. 


Technically Speaking Circle No. 151 
Phone: (508) 229-7777, Fax: (508) 229- 
8777 


Spoolview. Spoolview, a product 
released by Datatrade, now supports 
OS/2 client and server platforms. It is 
a multiplatform application that col- 
lects reports from all IBM host sys- 
tems via file transfer or tape input. 
The reports are then automatically 
indexed, compressed, and transferred 
to IBM 3995 optical media. Users have 
the ability to view, print, fax, and 
export data via LAN-based PCs run- 
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ning OS/2. Native IBM AFP advanced 
print streams are fully supported. 


Datatrade Circle No. 152 
Phone: (417) 882-1576, Fax: (417) 882- 
8423 


Snow Report Writer. Part of Snow's 
cross-platform family of client/server 
report-writing solutions, this product 
uses the common word processor 
metaphor to design, format, and place 
data in reports. The product incorpo- 
rates second-generation report-writing 
features. The Snow engine provides 
report-writing capabilities without 
requiring the knowledge of an underly- 
ing data access language, such as SOL. 


Snow Software Circle No. 153 
Phone: (813) 784-8899, Fax: (813) 787- 
1904 


AHA-2940 Ultra Wide. The AHA- 
2940 Ultra Wide single-channel PCI- 
to-SCSI host adapter offers faster 1/O 
throughput and improved efficiency 
for PCI-based systems by speeding 
data exchange between SCSI periph- 
erals and the PCI system at speeds of 
up to 40 MB/second. In addition, the 
adapter’s flexible design allows cus- 
tomers to utilize existing SCSI periph- 
erals, connections, and cabling, pro- 
tecting their existing investment. This 
product can also support the mixing 
of 8- and 16-bit devices on the same 
SCSI cable, without affecting the reli- 
able operation of the system. 


Adaptec Circle No. 154 
Phone: (408) 262 8600, Fax: (408) 262- 
2533 


UniMaint 4.0. UniMaint for OS/2 
uninstalls any OS/2 application, in- 
cluding freeware, shareware, or com- 
mercial software. In addition, Uni- 
Maint maintains OS/2 INI files and 
extended attributes while also per- 
forming desktop backups or portable 
desktop backups to port an OS/2 
desktop to your laptop computer or 
your machine at home. 


SofTouch Systems Inc. Circle No. 155 
Phone: (405) 947-8080, Fax: (405) 632- 
6537 





Bring enterprise-wide alphanumeric 
paging to your network and monitor 
mission critical applications across the 
enterprise with SkyAgent™. Save time, 
money and trim your I/S paging support 
costs by consolidating your enterprise's 
outbound paging operations into a single 
paging center. SkyAgent can be used to 
monitor system processes for 
predetermined events - which in turn can 
automatically page the §ipprepriate 

ort staff. 


Through leading edge TCP/IP SNMP 
technology and SkyAgent's SNMP 
extensible "paging" agent, every SNMP- 
ready host on your LAN or WAN has the 
capability to send multiple text messages 
to multiple pager devices in multiple 
locations with a single host SNMP 
command. 


Get important messages from all your 
computer systems to the right people in 
your organization at the right time, 24 
hours a day, 7 days a week, whether 
they're in New York, Los Angeles, or on 
an airplane somewhere in between. With 
SkyAgent, you avoid having to install 
paging software on every computer 
system in your enterprise. Plus, you get 
the ultimate, full-function paging server 
for all hosts on your network. 


You can ensure your mission critical 
apps are well taken care of - when you 
connect your best LAN support people 
with SkyAgent. 


Copynght GammatTech Inc. 1995 








@ Industry standard SNMP agent interface means sending requests to a SkyAgent server is as easy as 
issuing a single command from a host out across your network 




























@ Connectability to an unlimited number of "pager company" service providers through multiple, 
simultaneous, T.A.P. modem connections means you can reach anyone in any provider's service 
areas 


@ High volume message queuing and delivery rates can handle 500,000+ messages per month from 
hundreds of different systems 


@ Built-in user data base allows messages to be sent to nicknames and groups so that no one has to 
remember pager numbers -- This data base may be updated remotely via SNMP requests to lessen 


system administration costs 


@ SkyAgent standardizes your enterprise's computer-based paging and lowers paging support costs 
for your organization 


@ Complete logging, tracing, and diagnostic options ensure system and message accountability 


@ SkyAgent is designed around IBM's OS/2 Warp operating system and is a full 32-bit, multitasking 
server process 


© SkyAgent is designed to run in an unattended environment and may be monitored remotely from 
any type of SNMP "network management station" 


© MIB definition files are included for most common host platforms 


© Optionally purchase all hardware, configured "ready for use", and simply plug it into your networ 
for immediate computer-based paging service 





(800) 944-3028 Bad rax (405) 632-653 


SofTouch Systems, Inc. 
1300 S. Meridian, Suite 600, Oklahoma City, OK 73108-1751 
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It's easy to see why nothing propels you into the big 
leagues of object-oriented programming like our new 


VisualAge™ C++ version 3.0. 


Yeeesssss. It’s all over, baby. 


rr 


quickly. And with Open Class and C++ compilers for 
OS/2* Sun” Solaris!’ OS/400° AIX? and MVS. deploying 


your new object-oriented apps across 


It transcends mere GUI builders. Can your software do this? multiple platforms is really easy. We 
a ple | 


This fully integrated development 
environment lets you generate tight, fast client /server 
applications with point-and-click ease and efficiency. 

A simple drag-and-drop incorporates the 
truly scalable capabilities of a vast library of 
pre-built Open Class objects, which means 


you can create distributed client/server apps 


Get a Developer’s Kit including OS/2 Warp and a CD featuring an evaluation 
copy of DB2° v2 when you buy VisualAge C++ for OS/2* Call your authorized 
IBM reseller or 1 800 3IBM-0S2, Dept. SA019. 
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fice. VisualAge C++ for 0/400 will be available in 4th Otr 
ed their peenectien race Tin 


owners. "inioworld review, 5/8/95. © 1995 IBM Corporation. All rights reserved 


Tears are Te Peogerty oe Tear PeSOeCive 






“a masterpiece of visual programmin 
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thought that new features like these 


would excite you. /nfoworld agreed, and has called our 


new VisualAge C++ “object reusability at its finest” and 


g. 
True OO client/server development with 
VisualAge C++ for OS/2. It could be the 


best move you make. 


Solutions for a small planet” 







